Swagger Explorer MCP

Un servidor de plano de control de gestión (MCP) para explorar y analizar las especificaciones Swagger/OpenAPI a través de Claude.

Inicio rápido

Instalar y ejecutar globalmente usando npx:

O instalar con variables de entorno:

Instalación para Claude Desktop

1. Abra Claude Desktop

2. Haga clic en Configuración (icono de engranaje)

3. Seleccione "Herramientas e integraciones".

4. Haga clic en "Agregar servidor MCP"

5. Introduzca lo siguiente:

   Name: Swagger Explorer Command: npx -y @johnneerdael/swagger-mcp Arguments: --swagger-url=$SWAGGER_URL

6. Haga clic en "Instalar"

Uso con Claude

A continuación se muestran algunos ejemplos de interacciones con Claude:

Exploración básica de Swagger

Análisis de puntos finales específicos

Análisis de esquemas

Características

1. Soporte de autenticación

   • Autenticación de token de portador

   • Configurable a través de variables de entorno

2. Formato de respuesta personalizado

   • Formato mínimo: elimina valores nulos o vacíos

   • Formato detallado: incluye metadatos y marcas de tiempo.

   • Formato sin procesar: Respuesta sin modificar

3. Análisis de esquemas

   • Exploración detallada de la propiedad

   • Análisis del esquema de respuesta

   • Relaciones de esquema

4. Exploración de API

   • Listado de rutas

   • Filtrado de métodos

   • Análisis del formato de respuesta

Configuración

Variables de entorno:

• BASE_URL : Ruta base para la API (predeterminado: '')

• AUTH_TOKEN : Token portador para autenticación

• PORT : Puerto del servidor (predeterminado: 3000)

• SWAGGER_URL : URL de documentación de Swagger predeterminada

Puntos finales de API

Explorar API

Obtener detalles del esquema

Obtener esquemas de respuesta

Formatos de respuesta

Formato mínimo

Formato detallado

Casos de uso comunes

1. Revisión de la documentación de la API

   Human: Can you summarize all the available endpoints and their purposes?

2. Validación de esquemas

   Human: What fields are required for creating a new pet?

3. Análisis de respuesta

   Human: What are the possible error responses for the login endpoint?

4. Planificación de la integración

   Human: How should I structure my request to create a new order?

Solución de problemas

1. Problemas de conexión

   • Asegúrese de que la URL de Swagger sea accesible

   • Comprobar si el token de autenticación es correcto

   • Verificar que el puerto no esté en uso

2. Errores de autorización

   • Verifique que AUTH_TOKEN esté configurado correctamente

   • Asegúrese de que el token portador esté incluido en las solicitudes

3. Esquema no encontrado

   • Comprobar si el nombre del esquema coincide exactamente

   • Verifique que la especificación Swagger esté cargada correctamente

Notas de seguridad

1. El MCP requiere autenticación si AUTH_TOKEN está configurado

2. Todas las solicitudes se registran para su depuración.

3. La información confidencial no se almacena en caché

4. Se aplica una limitación de velocidad para evitar el abuso.

Desarrollo

Para contribuir o modificar:

1. Clonar el repositorio

2. Instalar dependencias:

   npm install

3. Construir:

   npm run build

4. Ejecutar localmente:

   npm start

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles