Swagger/OpenAPI MCP Server

Swagger/OpenAPI MCP Server

Un servidor de Model Context Protocol (MCP) que permite a los LLMs explorar e interactuar con especificaciones Swagger/OpenAPI. Este servidor proporciona herramientas y recursos para cargar especificaciones de API, navegar por endpoints y obtener información detallada sobre operaciones de API.

Instalación

1. Clona o crea el directorio del proyecto
2. Instala las dependencias:

npm install

3. Compila el código TypeScript:

npm run build

Uso

Herramientas Disponibles

load_api

Carga una especificación OpenAPI/Swagger en el servidor.

Parámetros:

• apiId (string): Identificador único para esta API
• source (string): URL o ruta de archivo a la especificación OpenAPI/Swagger

Ejemplo:

{
  "name": "load_api",
  "arguments": {
    "apiId": "petstore",
    "source": "https://petstore.swagger.io/v2/swagger.json"
  }
}

get_endpoint_details

Obtiene información detallada sobre un endpoint específico de la API.

Parámetros:

• apiId (string): ID de la API cargada
• method (string): Método HTTP (GET, POST, etc.)
• path (string): Ruta del endpoint de la API
• natural (boolean, opcional): Si es true, devuelve un resumen legible para humanos

Ejemplo:

{
  "name": "get_endpoint_details",
  "arguments": {
    "apiId": "petstore",
    "method": "GET",
    "path": "/pet/{petId}",
    "natural": true
  }
}

list_apis

Lista todas las especificaciones de API cargadas actualmente.

Parámetros: Ninguno

search_endpoints

Busca endpoints que coincidan con un patrón específico.

Parámetros:

• apiId (string): ID de la API cargada
• pattern (string): Patrón de búsqueda para rutas o descripciones de endpoints

Ejemplo:

{
  "name": "search_endpoints",
  "arguments": {
    "apiId": "petstore",
    "pattern": "pet"
  }
}

Recursos Disponibles

swagger://{apiId}/load

Obtiene información general sobre una especificación de API cargada.

swagger://{apiId}/endpoints

Obtiene una lista de todos los endpoints disponibles para una API.

swagger://{apiId}/endpoint/{method}/{path}

Obtiene información detallada sobre un endpoint específico.

Configuración con Claude Desktop

Para usar este servidor con Claude Desktop, añade lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "swagger-explorer": {
      "command": "node",
      "args": ["/path/to/your/swagger-mcp-server/build/index.js"]
    }
  }
}

Reemplaza /path/to/your/swagger-mcp-server con la ruta real a tu directorio del proyecto.

Licencia

Licencia MIT