Mise en place du projet MCP

La théorie du MCP est posée ; place à la pratique. Le reste de la section se construit autour d’un projet complet : un chatbot en ligne de commande qui démontre, code à l’appui, comment les clients et serveurs MCP fonctionnent ensemble. C’est le même esprit que le projet de rappels de la section outils — un fil rouge assez petit pour rester lisible, assez réaliste pour rencontrer les vrais problèmes.

Ce qu’on construit

Le produit final est un chatbot qui permet d’interagir avec une collection de documents en langage naturel : demander le contenu d’un rapport, le résumer, le corriger — le tout en tapant des phrases dans un terminal. Le système comprend deux moitiés :

• Un client MCP : gère les interactions utilisateur et communique avec Claude
• Un serveur MCP : fournit des outils pour lire et modifier des documents

Le serveur expose deux outils — lire le contenu d’un document et mettre à jour un document — qui opèrent sur une collection de documents stockée en mémoire. Ce choix du stockage en mémoire est délibéré : aucune base de données à installer, l’attention reste sur le protocole. Dans un serveur réel, ces mêmes outils iraient chercher les documents dans un système de fichiers, un CMS ou une base — sans que le client ni Claude n’aient à le savoir.

Note architecturale

Un point mérite d’être clarifié d’emblée, car il déroute souvent : dans un projet réel, on implémente typiquement soit un client MCP, soit un serveur MCP — rarement les deux. Si vous voulez exposer vos données ou vos outils à des applications existantes comme Claude Desktop, vous écrivez un serveur, et le client est fourni par ces applications. Si vous développez votre propre application de chat, vous écrivez un client, et vous vous connectez à des serveurs existants — les vôtres ou ceux de l’écosystème. Nous construisons les deux ici à des fins pédagogiques : voir les deux faces du protocole est le meilleur moyen de comprendre ce qui transite entre elles.

Configuration

La mise en route suit trois étapes :

1. Télécharger et extraire le projet CLI
2. Ajouter votre clé API dans le fichier .env
3. Installer les dépendances

Le lancement se fait ensuite au choix :

# Avec UV (recommande)
uv run main.py

# Avec Python standard
python main.py

UV est recommandé parce qu’il règle l’installation des dépendances et l’environnement virtuel en une commande — uv run lit le fichier projet, installe ce qui manque et exécute. Avec Python standard, pensez à créer votre environnement virtuel et à installer les dépendances au préalable ; le résultat est identique.

Le projet de démarrage n’est pas une coquille vide : il inclut déjà la fonctionnalité de chat basique avec Claude — la boucle de conversation, l’historique, l’affichage. C’est volontaire : tout cela, vous savez déjà l’écrire depuis les sections précédentes. Les prochaines leçons se concentrent exclusivement sur ce qui est nouveau — ajouter les capacités MCP : le serveur d’abord, son inspecteur, puis le client qui reliera le tout à la boucle de chat existante.

Points clés à retenir

• Projet fil rouge : un chatbot CLI qui manipule une collection de documents via MCP
• Deux moitiés : un client (interactions + Claude) et un serveur (outils de lecture/écriture de documents)
• En production, on écrit généralement soit un client, soit un serveur — les deux ici, pour voir les deux faces du protocole
• Configuration : projet extrait, clé API dans .env, dépendances — puis uv run main.py
• Le chat de base est fourni ; les leçons suivantes n’ajoutent que la couche MCP