Guide du Débutant pour Google MCP Toolbox Bases de Données

Introduction à la boîte à outils MCP

La boîte à outils MCP est un outil gratuit de Google qui aide vos applications d'IA à communiquer avec vos bases de données. Considérez-la comme un traducteur spécial. Votre IA peut demander des informations de manière simple, et la boîte à outils MCP traduit cette demande dans le langage que votre base de données comprend, comme SQL. Elle utilise ce qu'on appelle le protocole de contexte de modèle (MCP), qui est simplement un ensemble de règles standard pour ce type de communication.

Pourquoi utiliser la boîte à outils MCP

La boîte à outils MCP n'est pas seulement un traducteur ; elle facilite et améliore également la création de vos applications d'IA.

La boîte à outils MCP simplifie votre code

Sans la boîte à outils MCP, vous devez écrire beaucoup de code juste pour connecter votre IA à votre base de données. Vous avez besoin de code pour la connexion, la gestion des erreurs et la sécurité. Avec la boîte à outils MCP, il vous suffit de définir vos actions de base de données dans un simple fichier texte appelé tools.yaml. Ce fichier indique à la boîte à outils les actions possibles, et la boîte à outils gère tout le travail difficile de connexion sécurisée à la base de données.

La boîte à outils MCP améliore la vitesse et la sécurité

La boîte à outils MCP est conçue pour être rapide. Elle utilise une technique appelée « pooling de connexions », ce qui signifie qu'elle maintient les connexions à la base de données ouvertes et les réutilise. Cela permet de gagner beaucoup de temps par rapport à l'ouverture d'une nouvelle connexion pour chaque requête. Elle est également sécurisée car vous gérez tous les accès à la base de données en un seul endroit central, réduisant ainsi le risque d'erreurs.

La boîte à outils MCP vous montre ce qui se passe

Lorsque vous avez une IA, une boîte à outils et une base de données qui fonctionnent ensemble, il peut être difficile de voir ce qui se passe. La boîte à outils MCP intègre un support pour l'« observabilité », ce qui signifie qu'elle peut créer des journaux et des traces de chaque action. Cela vous aide à comprendre ce que font vos outils, à trouver d'éventuels problèmes et à voir comment accélérer les choses.

Comment la boîte à outils MCP s'intègre dans votre projet

La boîte à outils MCP se situe au milieu de votre application. Le flux ressemble à ceci :

1. Votre application d'IA : C'est là que réside votre modèle d'IA. Il décide qu'il a besoin d'informations de la base de données pour répondre à une question.
2. La boîte à outils MCP : L'application d'IA envoie une requête à la boîte à outils MCP. La boîte à outils examine son fichier tools.yaml, trouve l'outil approprié pour la tâche et exécute la commande correspondante sur votre base de données.
3. Votre base de données : La base de données exécute la commande et renvoie les données à la boîte à outils MCP, qui les transmet ensuite à votre IA.

Cette configuration signifie que votre application d'IA principale n'a pas besoin de connaître les détails complexes du fonctionnement de votre base de données. Vous pouvez même modifier vos outils ou votre base de données sans avoir à réécrire le code de votre application d'IA.

Un guide étape par étape pour utiliser la boîte à outils MCP

Voyons comment faire fonctionner la boîte à outils MCP sur votre ordinateur.

Étape 1 : Préparer votre base de données pour la boîte à outils MCP

Tout d'abord, vous avez besoin d'une base de données. Ces étapes utilisent PostgreSQL comme exemple. Vous allez créer un utilisateur spécial et une base de données pour la boîte à outils.

Connectez-vous à votre serveur PostgreSQL.

Exécutez ces commandes SQL pour créer un utilisateur nommé toolbox_user et une base de données nommée toolbox_db :

CREATE USER toolbox_user WITH PASSWORD 'my-password';
CREATE DATABASE toolbox_db;
GRANT ALL PRIVILEGES ON DATABASE toolbox_db TO toolbox_user;

Créez une table d'exemple, comme une table hotels, afin que vos outils aient des données avec lesquelles travailler.

Étape 2 : Installer et configurer la boîte à outils MCP

Ensuite, vous allez configurer la boîte à outils elle-même.

Téléchargez le programme de la boîte à outils MCP depuis sa page de publication officielle sur GitHub. Assurez-vous d'obtenir la bonne version pour votre ordinateur (comme Windows, Mac ou Linux).

Créez un nouveau fichier nommé tools.yaml. Ce fichier est l'endroit où vous définirez toutes les actions que votre IA peut effectuer. Voici un exemple simple :

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

tools:
  search-hotels-by-location:
    kind: postgres-sql
    source: my-pg-source
    description: Finds hotels in a specific city.
    parameters:
      - name: location
        type: string
        description: The city to search for hotels in.
    statement: SELECT * FROM hotels WHERE location = $1;

Étape 3 : Exécuter le serveur de la boîte à outils MCP

Vous pouvez maintenant démarrer la boîte à outils. Ouvrez votre terminal, accédez au dossier où vous avez téléchargé la boîte à outils et exécutez cette commande :

./toolbox --tools-file "tools.yaml"

Le serveur démarrera et chargera les outils que vous avez définis.

Comment tester avec l'Inspecteur de la boîte à outils MCP

La boîte à outils MCP est livrée avec un outil de test appelé l'Inspecteur. C'est une page web qui vous permet d'essayer vos outils sans avoir à écrire de code.

1. Exécutez l'Inspecteur depuis votre terminal avec cette commande : npx @modelcontextprotocol/inspector.
2. Ouvrez l'adresse web qu'il vous donne dans votre navigateur.
3. Dites-lui de se connecter à votre serveur MCP Toolbox en cours d'exécution (généralement à http://127.0.0.1:5000/mcp/sse).
4. Une fois connecté, vous pouvez voir une liste de vos outils, remplir leurs paramètres et les exécuter pour vérifier s'ils fonctionnent correctement.

Comment connecter votre application à la boîte à outils MCP

Après les tests, vous pouvez connecter votre véritable application d'IA. La boîte à outils MCP dispose de SDK (kits de développement logiciel) pour faciliter cela. Voici un exemple Python simple :

Installez le SDK Python : pip install toolbox-core.

Utilisez ce code pour vous connecter à la boîte à outils et charger vos outils :

from toolbox_core import ToolboxClient
import asyncio

async def main():
    async with ToolboxClient("http://127.0.0.1:5000") as client:
        tools = await client.load_toolset()
        # The 'tools' variable now holds your database tools
        # and you can give them to your AI model.
        print("Tools loaded successfully!")

asyncio.run(main())

Ce code se connecte au serveur de la boîte à outils et télécharge les outils que vous avez définis. Vous pouvez ensuite donner ces outils à votre agent IA, et il pourra les utiliser pour interagir avec votre base de données.

Réflexions finales sur la boîte à outils MCP

La boîte à outils MCP de Google est un outil fantastique pour tout développeur travaillant avec l'IA et les bases de données. Elle simplifie votre code, rend votre application plus rapide et plus sécurisée, et vous offre la visibilité dont vous avez besoin pour comprendre comment tout fonctionne. En suivant les étapes de ce guide, vous pouvez commencer à utiliser la boîte à outils MCP pour créer des applications d'IA plus puissantes et basées sur les données.