Outils - Documentation Officielle MCP (Française)

Permettre aux LLMs d'effectuer des actions via votre serveur

Les outils sont une primitive puissante dans le Model Context Protocol (MCP) qui permet aux serveurs d'exposer des fonctionnalités exécutables aux clients. Grâce aux outils, les LLMs peuvent interagir avec des systèmes externes, effectuer des calculs et agir dans le monde réel.

Les outils sont conçus pour être contrôlés par le modèle, ce qui signifie que les outils sont exposés des serveurs aux clients avec l'intention que le modèle d'IA puisse les invoquer automatiquement (avec un humain dans la boucle pour accorder l'approbation).

Aperçu

Les outils dans MCP permettent aux serveurs d'exposer des fonctions exécutables qui peuvent être invoquées par les clients et utilisées par les LLMs pour effectuer des actions. Les aspects clés des outils incluent :

Découverte : Les clients peuvent lister les outils disponibles via le point de terminaison tools/list

Invocation : Les outils sont appelés à l'aide du point de terminaison tools/call, où les serveurs effectuent l'opération demandée et renvoient les résultats

Flexibilité : Les outils peuvent aller de simples calculs à des interactions API complexes

Comme les ressources, les outils sont identifiés par des noms uniques et peuvent inclure des descriptions pour guider leur utilisation. Cependant, contrairement aux ressources, les outils représentent des opérations dynamiques qui peuvent modifier l'état ou interagir avec des systèmes externes.

Structure de définition d'outil

Chaque outil est défini avec la structure suivante :

Implémentation des outils

Voici un exemple d'implémentation d'un outil de base dans un serveur MCP :

TypeScript

Python

Exemples de modèles d'outils

Voici quelques exemples de types d'outils qu'un serveur pourrait fournir :

Opérations système

Outils qui interagissent avec le système local :

Intégrations API

Outils qui encapsulent des API externes :

Traitement des données

Outils qui transforment ou analysent des données :

Meilleures pratiques

Lors de l'implémentation d'outils :

Fournissez des noms et des descriptions clairs et descriptifs

Utilisez des définitions JSON Schema détaillées pour les paramètres

Incluez des exemples dans les descriptions d'outils pour démontrer comment le modèle doit les utiliser

Implémentez une gestion des erreurs et une validation appropriées

Utilisez la création de rapports d'avancement pour les opérations longues

Gardez les opérations d'outils ciblées et atomiques

Documentez les structures de valeurs de retour attendues

Implémentez des délais d'attente appropriés

Envisagez de limiter le débit pour les opérations gourmandes en ressources

10.

Enregistrez l'utilisation des outils pour le débogage et la surveillance

Considérations de sécurité

Lors de l'exposition d'outils :

Validation des entrées

Validez tous les paramètres par rapport au schéma

Nettoyez les chemins de fichiers et les commandes système

Validez les URL et les identifiants externes

Vérifiez les tailles et les plages des paramètres

Empêchez l'injection de commandes

Contrôle d'accès

Implémentez l'authentification si nécessaire

Utilisez les vérifications d'autorisation appropriées

Auditez l'utilisation des outils

Limitez le débit des requêtes

Surveillez les abus

Gestion des erreurs

N'exposez pas les erreurs internes aux clients

Enregistrez les erreurs pertinentes pour la sécurité

Gérez les délais d'attente de manière appropriée

Nettoyez les ressources après les erreurs

Validez les valeurs de retour

Découverte et mises à jour des outils

MCP prend en charge la découverte dynamique des outils :

Les clients peuvent lister les outils disponibles à tout moment

Les serveurs peuvent notifier les clients lorsque les outils changent à l'aide de notifications/tools/list_changed

Les outils peuvent être ajoutés ou supprimés pendant l'exécution

Les définitions d'outils peuvent être mises à jour (bien que cela doive être fait avec précaution)

Gestion des erreurs

Les erreurs d'outil doivent être signalées dans l'objet de résultat, et non en tant qu'erreurs au niveau du protocole MCP. Cela permet au LLM de voir et potentiellement de gérer l'erreur. Lorsqu'un outil rencontre une erreur :

Définissez isError sur true dans le résultat

Incluez les détails de l'erreur dans le tableau content

Voici un exemple de gestion appropriée des erreurs pour les outils :

TypeScript

Python

Cette approche permet au LLM de voir qu'une erreur s'est produite et potentiellement de prendre des mesures correctives ou de demander une intervention humaine.

Test des outils

Une stratégie de test complète pour les outils MCP doit couvrir :

Tests fonctionnels : Vérifiez que les outils s'exécutent correctement avec des entrées valides et gèrent les entrées non valides de manière appropriée

Tests d'intégration : Testez l'interaction de l'outil avec des systèmes externes en utilisant des dépendances réelles et simulées

Tests de sécurité : Validez l'authentification, l'autorisation, l'assainissement des entrées et la limitation du débit

Tests de performance : Vérifiez le comportement sous charge, la gestion des délais d'attente et le nettoyage des ressources

Gestion des erreurs : Assurez-vous que les outils signalent correctement les erreurs via le protocole MCP et nettoient les ressources