TP : création d'un serveur d'outils avec MCP pour un Agent IA

Installation

Ouvrir un terminal dans le dossier racine du projet :

poetry install # installer les dépendances nécessaires

Attention, si derrière un proxy, vous devez ajouter en haut du fichier run_agent.py les lignes suivantes :

import os
os.environ["NO_PROXY"] = "127.0.0.1,localhost"

Objectif du TP

L'objectif de ce travail pratique est de développer un petit serveur d'outils en utilisant le protocole MCP (Model Context Protocol). Ce serveur exposera des fonctionnalités Python spécifiques (nos "outils") que des agents d'intelligence artificielle, comme ceux basés sur de grands modèles de langage (LLM), pourront découvrir et utiliser pour accomplir des tâches.

Dans ce scénario, nous allons créer un serveur qui donne accès à une base de données de films. Un agent LangChain, dont le code vous est entièrement fourni (run_agent.py), se connectera à votre serveur pour récupérer des informations sur les films et répondre aux questions d'un utilisateur.

Votre mission est de compléter le squelette du fichier mcp_tool_server.py pour le rendre fonctionnel.

1. Contexte : qu'est-ce qu'un serveur MCP ?

Avant de commencer à coder, il est essentiel de comprendre le rôle d'un serveur MCP, qui est au centre de l'IA Agentique. Prenez un moment pour effectuer des recherches sur les questions suivantes :

Qu'est-ce que le protocole MCP (Model Context Protocol) ?
À quel besoin répond-il dans une architecture basée sur des agents IA ?
- Quelle est la différence entre exposer une fonction via une API REST classique et via un serveur d'outils ?

Les diagrammes suivants illustrent la différence fondamentale d'approche :

graph TD
    subgraph "Architecture API REST classique"
        Client[Application Client] -- "Requête HTTP GET /films" --> APIRest["Serveur API REST"]
        APIRest -- "Logique métier" --> Endpoint1["Endpoint /films"]
        APIRest -- "Logique métier" --> Endpoint2["Endpoint /acteur"]
        Client -- "Requête HTTP POST /acteur" --> APIRest
    end

graph TD
    subgraph "Architecture Agent MCP"
        Agent["Agent IA / LLM"] -- "1. Découverte: 'Quels outils as-tu?'" --> MCPServeur["Serveur d'outils MCP"]
        MCPServeur -- "Expose 'get_film_details'" --> Outil1[Fonction Python: get_film_details]
        MCPServeur -- "Expose 'search_by_actor'" --> Outil2[Fonction Python: search_by_actor]
        Agent -- "2. Appel: 'get_film_details NomDuFilm'" --> MCPServeur
    end

Cette recherche vous aidera à mieux saisir l'importance de chaque ligne de code que vous écrirez.

2. Fichiers fournis

Vous disposez des fichiers suivants :

mcp_tool_server.py (À COMPLÉTER) : Le squelette du serveur que vous devez développer.
run_agent.py (COMPLET) : Le client qui exécute l'agent LangChain. Vous n'avez pas besoin de le modifier, mais n'hésitez pas à l'étudier pour comprendre comment il découvre et appelle les outils de votre serveur.
Un répertoire resources contenant servers.json, utilisé par run_agent.py pour connaître l'adresse de votre serveur.

Voici comment ces éléments interagissent dans ce TP :

graph TD
    Utilisateur -- "Pose une question" --> Agent["Agent LangChain (run_agent.py)"]

    Agent -- "Lit la config" --> Config["servers.json"]
    Agent -- "Se connecte et découvre les outils (MCP)" --> Serveur["Votre Serveur (mcp_tool_server.py)"]
    
    Serveur -- "Implémente les outils" --> LogiqueMetier["Logique des outils (ex: recherche film)"]
    LogiqueMetier -- "Accède" --> DB["Base de données Films (simulée)"]

    Agent -- "Appelle l'outil nécessaire" --> Serveur
    Serveur -- "Retourne le résultat" --> Agent
    Agent -- "Formule la réponse" --> Utilisateur

3. Travail à réaliser : Compléter le serveur d'outils

Ouvrez le fichier mcp_tool_server.py et suivez les étapes ci-dessous pour le compléter. Les sections à modifier sont indiquées par des commentaires # TODO.

4. Facultatif : aller plus loin

Une fois que vous avez un serveur fonctionnel, vous pouvez envisager d'ajouter des fonctionnalités supplémentaires :

Rendre l'agent accessible depuis une API REST (ou au choix GraphQL), permettant à un utilisateur final de la Filmothèque (via un ChatBot par exemple) de poser des questions sur les films via des requêtes HTTP.
Ajouter des outils supplémentaires, comme la recherche de films par titre, la réservation de billets de cinéma, l'achat du film sur Amazon directement par l'Agent IA, etc. Donnez libre cours à votre imagination !

4.6 KiB Raw Blame History