Nous allons construire un chatbot basé sur une interface en ligne de commande qui démontre comment les clients et serveurs MCP fonctionnent ensemble. Ce projet pratique vous donnera une expérience concrète des deux côtés de l'architecture MCP.
Ce que nous allons construire
Notre chatbot permettra aux utilisateurs d'interagir avec une collection de documents en langage naturel. Le système se compose de deux éléments principaux :
- Un client MCP qui gère les interactions utilisateur et communique avec Claude
- Un serveur MCP qui fournit des outils pour lire et mettre à jour des documents

Le serveur exposera deux outils à Claude :
- Un outil pour lire le contenu d'un document
- Un outil pour mettre à jour le contenu d'un document
Tous les documents sont stockés en mémoire par souci de simplicité - ils incluent des fichiers comme document.pdf, spreadsheet.xlsx, report.txt et spec.md.
Remarque importante sur l'architecture
Dans les projets réels, vous implémentez généralement soit un client MCP, soit un serveur MCP, mais pas les deux. Vous pourriez construire :
- Seulement un serveur MCP pour exposer les fonctionnalités de votre service aux modèles d'IA
- Seulement un client MCP pour vous connecter à des serveurs MCP existants, construits par d'autres développeurs

Nous construisons les deux éléments dans ce projet uniquement à des fins pédagogiques - afin de comprendre comment ils communiquent et fonctionnent ensemble.
Configuration du projet
Téléchargez cli_project.zip depuis la section Téléchargements à la fin de cette leçon, puis extrayez-le dans le répertoire de développement de votre choix. Ouvrez votre éditeur de code dans le dossier du projet.
Configuration
Le projet inclut un fichier README.md contenant des instructions détaillées de configuration. Vous devrez :
- Ajouter votre clé API Anthropic dans le fichier .env
- Installer les dépendances en utilisant soit UV (recommandé), soit pip

Le fichier .env doit contenir :
ANTHROPIC_API_KEY="your-api-key-here"Exécution du projet
Une fois la configuration terminée, accédez au répertoire de votre projet dans le terminal et exécutez :
# Si vous utilisez UV (recommandé)
uv run main.py
# Si vous utilisez Python standard
python main.pyUne invite de conversation devrait s'afficher. Testez-la en posant une question simple comme « combien fait 1+1 ? » pour vérifier que tout fonctionne correctement.
Le projet de démarrage inclut déjà une fonctionnalité de chat de base avec Claude. Dans les vidéos suivantes, nous ajouterons les capacités du serveur MCP ainsi que des fonctionnalités de gestion de documents pour créer un chatbot pleinement fonctionnel, capable de comprendre des documents.
Téléchargements
- Télécharger
Starter project (cli_project.zip)
The chatbot project you build on for the rest of this section.
- Télécharger
Completed project (cli_project_COMPLETE.zip)
The finished version, for checking your work.