fanfarronería-mcp

Descripción general

swagger-mcp es una herramienta diseñada para extraer información de la interfaz de usuario de Swagger extrayendo el archivo swagger.json y generando dinámicamente herramientas mcp bien definidas en tiempo de ejecución. El cliente MCP puede utilizar estas herramientas para una mayor selección de herramientas.

📽️ Vídeo de demostración

Vea el video de demostración que muestra el proyecto en acción:

🙌 Apoyo

Si consideras que este proyecto es valioso, por favor, apóyame en LinkedIn mediante:

👍 Dale me gusta y comparte nuestra publicación de demostración
💬 Deja tus pensamientos y opiniones en los comentarios.
🔗 Conéctate conmigo para futuras actualizaciones

¡Tu apoyo en LinkedIn me ayudará a llegar a más personas y mejorar el proyecto!

Prerrequisitos

Para utilizar swagger-mcp , asegúrese de tener las siguientes dependencias:

Clave API del modelo LLM/LLM local : requiere acceso a los modelos OpenAI, Claude u Ollama.
Cualquier cliente MCP : (se utiliza mark3labs - mcphost )

Instalación y configuración

Siga estos pasos para instalar y ejecutar swagger-mcp :

go install github.com/danishjsheikh/swagger-mcp@latest
swagger-mcp

Configuración de ejecución

Para ejecutar swagger-mcp directamente, use:

swagger-mcp --specUrl=https://your_swagger_api_docs.json

Banderas principales:

--specUrl : URL JSON de Swagger/OpenAPI (obligatorio)
--sseMode : Ejecutar en modo SSE (predeterminado: falso, si es verdadero se ejecuta como servidor SSE, de lo contrario usa stdio)
--sseAddr : Dirección de escucha del servidor SSE en formato IP:Puerto o :Puerto (si está vacío, se utilizará IP:Puerto de --sseUrl)
--sseUrl : URL base del servidor SSE (si está vacío, se utilizará sseAddr para generar, por ejemplo, http://IP:Port o http://localhost:Port )
Si se configuran --sseAddr y --sseUrl, se utilizan tal como están, sin complemento automático.
--baseUrl : Anular la URL base para las solicitudes de API
--security : tipo de seguridad de API ( basic , apiKey o bearer )
--basicAuth : Autenticación básica en formato usuario:contraseña
--bearerAuth : Token de portador para el encabezado de autorización
--apiKeyAuth : clave(s) API, formato passAs:name=value (por ejemplo header:token=abc,query:user=foo,cookie:sid=xxx )
Consulte main.go para ver todas las opciones y banderas admitidas.

Configuración de MCP

Para integrar con mcphost , incluya la siguiente configuración en .mcp.json :

{
    "mcpServers":
    {
        "swagger_loader": {
            "command": "swagger-mcp",
            "args": ["--specUrl=<swagger/doc.json_url>"]
        }
    }
}

Flujo de demostración

Algunos backend:
go install github.com/danishjsheikh/go-backend-demo@latest go-backend-demo
Ollama
ollama run llama3.2
Cliente MCP
go install github.com/mark3labs/mcphost@latest mcphost -m ollama:llama3.2 --config <.mcp.json_file_path>

Diagrama de flujo

🛠️ ¿Necesitas ayuda?

Estoy trabajando para mejorar las definiciones de herramientas para mejorar:
✅ Mejor manejo de errores para respuestas más precisas
✅ Control de comportamiento de LLM para garantizar que se base únicamente en las respuestas de la API y no utilice su propia memoria
✅ Prevención de alucinaciones y generación aleatoria de datos mediante la aplicación de una recuperación estricta de datos desde las API

Si tienes ideas o sugerencias para mejorar estos aspectos, por favor contribuye:

Compartiendo su experiencia con implementaciones similares
Sugerir modificaciones a las definiciones de herramientas
Proporcionar retroalimentación sobre las limitaciones actuales

¡Sus aportaciones serán invaluables para hacer que esta herramienta sea más confiable y efectiva! 🚀

swagger-mcp

Integrations