Chargement

Configuration du projet

Leçon 517 min
Chargement

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

Notre serveur héberge notre client MCP, qui dialogue dans les deux sens avec notre serveur MCP, dont les outils lisent et mettent à jour quatre 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

Schéma de notre serveur contenant le client MCP, qui se connecte dans les deux sens à un serveur MCP distinct.

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 :

  1. Ajouter votre clé API Anthropic dans le fichier .env
  2. Installer les dépendances en utilisant soit UV (recommandé), soit pip

Le fichier README.md du projet, avec l'étape 1 pour définir ANTHROPIC_API_KEY dans le fichier .env et l'étape 2 pour installer les dépendances.

Le fichier .env doit contenir :

bash
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 :

bash
# Si vous utilisez UV (recommandé)
uv run main.py

# Si vous utilisez Python standard
python main.py

Une 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

  • 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.

    Télécharger