swagger-mcp

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:

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

Instalación y configuración

Siga estos pasos para instalar y ejecutar swagger-mcp :

Configuración de ejecución

Para ejecutar swagger-mcp directamente, use:

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 o (si está vacío, se utilizará IP 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ñ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 :

Flujo de demostración

1. Algunos backend:
   go install github.com/danishjsheikh/go-backend-demo@latest go-backend-demo
2. Ollama
   ollama run llama3.2
3. 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! 🚀