YaSwag

Ce qu'il fait

YaSwag est un outil complet pour les développeurs Go permettant de générer des spécifications OpenAPI 3.x à partir du code source en utilisant des annotations personnalisées. Au-delà de la génération, il fournit un serveur MCP qui permet aux assistants IA d'interagir avec les spécifications d'API via une recherche sémantique et l'exploration de schémas, transformant ainsi vos documents d'API en une base de connaissances interactive pour l'IA.

Outils

• search_endpoints : Rechercher des points de terminaison (endpoints) d'API en langage naturel.
• list_endpoints : Lister tous les points de terminaison disponibles avec filtrage optionnel.
• get_endpoint : Récupérer des informations détaillées sur un point de terminaison spécifique.
• search_schemas : Rechercher dans les définitions de schémas.
• get_schema : Obtenir une vue détaillée d'une définition de schéma spécifique.
• validate_spec : Valider la spécification OpenAPI actuelle.
• get_spec_info : Obtenir des informations générales sur la spécification de l'API.
• generate_example : Créer des exemples de données de requête et de réponse.
• find_related : Découvrir les points de terminaison liés à l'actuel.
• list_tags : Lister tous les tags d'API et le nombre de points de terminaison associés.
• analyze_security : Effectuer une analyse de sécurité des exigences de l'API.

Installation

Ajoutez ce qui suit à votre fichier claude_desktop_config.json :

{
  "mcpServers": {
    "yaswag": {
      "command": "yaswag",
      "args": ["mcp", "./openapi.json"]
    }
  }
}

Hôtes supportés

• Claude