Nous allons construire un chatbot basé sur une interface en ligne de commande (CLI) 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 construisons
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 des projets réels, vous implémentez généralement soit un client MCP, soit un serveur MCP, mais pas les deux. Vous pourriez construire :
- Uniquement un serveur MCP pour exposer les capacités de votre service aux modèles d'IA
- Uniquement un client MCP pour vous connecter à des serveurs MCP existants construits par d'autres développeurs

Nous construisons les deux composants dans ce projet uniquement à des fins pédagogiques - pour 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 et extrayez-le dans votre répertoire de développement préféré. Ouvrez votre éditeur de code dans le dossier du projet.
Configuration
Le projet inclut un fichier README.md avec des instructions de configuration détaillées. Vous devrez :
- Ajouter votre clé API Anthropic au 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 à votre répertoire de projet dans le terminal et exécutez :
# Si vous utilisez UV (recommandé)
uv run main.py
# Si vous utilisez Python standard
python main.pyVous devriez voir apparaître une invite de chat. Testez-la en posant une question simple comme « combien font 1+1 ? » pour vérifier que tout fonctionne correctement.
Le projet de départ inclut déjà une fonctionnalité de chat de base avec Claude. Dans les vidéos suivantes, nous ajouterons des capacités de serveur MCP et des fonctionnalités de gestion de documents pour créer un chatbot entièrement fonctionnel et conscient 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.