Serveur MCP Schéma OpenAPI

Que fait le serveur MCP “Schéma OpenAPI” ?

Le serveur MCP Schéma OpenAPI est un serveur Model Context Protocol (MCP) conçu pour exposer les informations de schéma OpenAPI aux grands modèles de langage (LLM) tels que Claude. En fournissant un accès structuré aux spécifications OpenAPI, ce serveur permet aux assistants IA d’explorer et de comprendre les APIs, y compris leurs endpoints, paramètres, schémas de requête et de réponse, et plus encore. Cela permet aux développeurs et aux outils IA d’interroger la structure d’une API, de rechercher dans les spécifications et de récupérer des définitions de schéma détaillées, ce qui améliore les workflows liés à l’intégration d’API, à la documentation et à la génération de code. Le serveur prend en charge le chargement de fichiers OpenAPI au format JSON ou YAML et fournit les résultats en YAML pour une meilleure compréhension par les LLM.

Liste des prompts

Aucun modèle de prompt explicite n’est documenté dans le dépôt.

Liste des ressources

Aucune ressource explicite n’est décrite dans le dépôt.

Liste des outils

Le serveur MCP Schéma OpenAPI propose les outils suivants pour les LLM :

• list-endpoints : Liste tous les chemins d’API et leurs méthodes HTTP avec des résumés dans une structure d’objet imbriquée.
• get-endpoint : Récupère des informations détaillées sur un endpoint spécifique, y compris les paramètres et les réponses.
• get-request-body : Fournit le schéma du corps de requête pour un endpoint et une méthode HTTP spécifiques.
• get-response-schema : Retourne le schéma de réponse pour un endpoint, une méthode et un code d’état spécifiques.
• get-path-parameters : Récupère les paramètres d’un chemin spécifique.
• list-components : Liste tous les composants de schéma (schémas, réponses, paramètres, etc.).
• get-component : Retourne la définition détaillée d’un composant spécifique.
• list-security-schemes : Liste tous les schémas de sécurité disponibles dans l’API.
• get-examples : Récupère des exemples pour un composant ou endpoint spécifique.
• search-schema : Recherche dans les chemins, opérations et schémas de la spécification OpenAPI.

Cas d’utilisation de ce serveur MCP

• Exploration et documentation d’API : Les développeurs ou LLM peuvent rapidement lister les endpoints, paramètres et schémas, facilitant la documentation ou la compréhension de la structure d’une API.
• Génération automatisée de code : En récupérant de manière programmatique les schémas de requête et de réponse, les outils peuvent générer des bibliothèques clientes ou des extraits de code pour l’interaction avec l’API.
• Test et validation d’API : Les outils de test peuvent utiliser ce serveur pour obtenir des paramètres et exemples de payload, facilitant les tests API automatisés ou manuels.
• Revue de sécurité : Analysez les schémas de sécurité disponibles et leur implémentation sur les endpoints pour garantir la sécurité des APIs.
• Recherche et analyse de schémas : Trouvez et analysez rapidement les composants de schéma ou endpoints liés à une entité ou fonctionnalité spécifique au sein de grandes spécifications API.

Comment le configurer

Windsurf

Aucune instruction de configuration fournie pour Windsurf.

Claude

1. Vérifiez que Node.js et npx sont installés.
2. Localisez votre fichier de configuration Claude Desktop :
   • macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : $env:AppData\Claude\claude_desktop_config.json
3. Ajoutez le serveur MCP Schéma OpenAPI sous l’objet mcpServers :

   {
     "mcpServers": {
       "OpenAPI Schema": {
         "command": "npx",
         "args": ["-y", "mcp-openapi-schema", "/CHEMIN/ABSOLU/VERS/openapi.yaml"]
       }
     }
   }
   

4. Enregistrez le fichier et redémarrez Claude Desktop.
5. Vérifiez que le serveur est disponible dans l’interface Claude.

Cursor

Aucune instruction de configuration fournie pour Cursor.

Cline

Claude Code CLI

1. Vérifiez que Node.js et npx sont installés.
2. Ajoutez le serveur MCP Schéma OpenAPI :

   claude mcp add openapi-schema npx -y mcp-openapi-schema
   

   Ou avec un fichier de schéma spécifique :

   claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
   

3. Vérifiez l’enregistrement :

   claude mcp list
   claude mcp get openapi-schema
   

4. Facultativement, supprimez le serveur :

   claude mcp remove openapi-schema
   

5. Utilisez les outils dans votre session Claude Code.

Sécurisation des clés API

Aucune information fournie concernant la sécurisation des clés API ou l’utilisation de variables d’environnement.

Comment utiliser ce MCP dans les flux

Utilisation du MCP dans FlowHunt

Pour intégrer des serveurs MCP dans votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flux et connectez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section de configuration système MCP, insérez les détails de votre serveur MCP en utilisant ce format JSON :

{
  "Nom-du-MCP": {
    "transport": "streamable_http",
    "url": "https://votreserveurmcp.exemple/cheminversmcp/url"
  }
}

Une fois configuré, l’agent IA est alors en mesure d’utiliser ce MCP comme un outil avec accès à toutes ses fonctions et capacités. Pensez à remplacer “Nom-du-MCP” par le nom réel de votre serveur MCP (par exemple, “github-mcp”, “weather-api”, etc.) et l’URL par celle de votre propre serveur MCP.

Vue d’ensemble

D’après la documentation disponible, le serveur MCP Schéma OpenAPI est très spécialisé pour l’exploration OpenAPI via LLM, offrant un ensemble d’outils solide mais manquant de détails sur les prompts, les ressources, la gestion des clés API et les fonctionnalités MCP avancées. Pour les cas d’usage OpenAPI, il est robuste ; pour les fonctionnalités MCP plus larges, il est limité.

Score MCP

Évaluation :
Je donnerais à ce serveur MCP la note de 6/10. Bien qu’il soit bien défini pour l’exploration de schémas OpenAPI et offre un ensemble d’outils puissants, il manque de documentation sur les modèles de prompt MCP, de définitions de ressources explicites, de bonnes pratiques de sécurité, et ne mentionne pas la prise en charge des racines ou de l’échantillonnage. L’absence de LICENSE est aussi une limitation importante pour la collaboration ouverte.