Openapi MCP

Servidor OpenAPI MCP

Um servidor MCP que permite que LLMs inspecionem e interajam com especificações OpenAPI.

Recursos

• Carregar especificações OpenAPI de URL ou arquivo (OpenAPI 2.0 e 3.x)
• Listar e pesquisar endpoints
• Obter esquemas de requisição/resposta (totalmente desreferenciados)
• Validar payloads contra esquemas
• Gerar payloads de requisição de exemplo
• Gerar tipos TypeScript a partir de esquemas
• Extrair esquemas de autenticação

Instalação

npm install -g @blackkspydo/openapi-mcp

Ou execute diretamente com npx:

npx --yes @blackkspydo/openapi-mcp

A partir do código-fonte

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

Uso

Com Claude CLI

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

Com Claude Desktop

Adicione a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Ou se instalado globalmente:

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

Autônomo

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

Ferramentas Disponíveis

Ferramenta	Descrição
load_spec	Carregar uma especificação OpenAPI de URL ou arquivo
list_endpoints	Listar todos os endpoints com filtragem opcional
search_endpoints	Pesquisar endpoints por palavra-chave
get_endpoint_details	Obter detalhes completos de um endpoint
get_request_schema	Obter esquema do corpo da requisição
get_response_schema	Obter esquema de resposta por código de status
validate_payload	Validar JSON contra esquema
generate_sample	Gerar payload de requisição de exemplo
generate_typescript_types	Gerar interfaces TypeScript a partir de esquemas
generate_curl	Gerar comando cURL pronto para uso
get_auth_schemes	Obter esquemas de segurança
get_servers	Obter servidores de API disponíveis

Exemplo

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

Licença

MIT