Openapi MCP

Servidor OpenAPI MCP

Un servidor MCP que permite a los LLM inspeccionar e interactuar con especificaciones OpenAPI.

Características

• Cargar especificaciones OpenAPI desde URL o archivo (OpenAPI 2.0 y 3.x)
• Listar y buscar endpoints
• Obtener esquemas de solicitud/respuesta (completamente desreferenciados)
• Validar cargas útiles contra esquemas
• Generar cargas útiles de solicitud de ejemplo
• Generar tipos TypeScript a partir de esquemas
• Extraer esquemas de autenticación

Instalación

npm install -g @blackkspydo/openapi-mcp

O ejecutar directamente con npx:

npx --yes @blackkspydo/openapi-mcp

Desde el código fuente

git clone https://github.com/blackkspydo/openapi-mcp.git
cd openapi-mcp
bun install
bun run build

Uso

Con Claude CLI

claude mcp add openapi-mcp -- npx --yes @blackkspydo/openapi-mcp

Con Claude Desktop

Añadir a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["--yes", "@blackkspydo/openapi-mcp"]
    }
  }
}

O si está instalado globalmente:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "openapi-mcp"
    }
  }
}

Independiente

openapi-mcp
# or
npx --yes @blackkspydo/openapi-mcp

Herramientas Disponibles

Herramienta	Descripción
load_spec	Cargar una especificación OpenAPI desde URL o archivo
list_endpoints	Listar todos los endpoints con filtrado opcional
search_endpoints	Buscar endpoints por palabra clave
get_endpoint_details	Obtener detalles completos de un endpoint
get_request_schema	Obtener el esquema del cuerpo de la solicitud
get_response_schema	Obtener el esquema de respuesta por código de estado
validate_payload	Validar JSON contra el esquema
generate_sample	Generar carga útil de solicitud de ejemplo
generate_typescript_types	Generar interfaces TypeScript a partir de esquemas
generate_curl	Generar comando cURL listo para usar
get_auth_schemes	Obtener esquemas de seguridad
get_servers	Obtener servidores API disponibles

Ejemplo

You: Load the Petstore API spec from https://petstore.swagger.io/v2/swagger.json

You: List all POST endpoints

You: Generate TypeScript types for the Pet schema

You: Generate a cURL command for POST /pet

You: Generate a sample request for POST /pet

Licencia

MIT