convez.ai
MCP ServerIntegração & APIsIntermediário
bbonnin

OpenAPI MCP Server

bbonnin/openapi-to-mcp

Transforma especificações OpenAPI em tools MCP funcionais instantaneamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que converte automaticamente especificações OpenAPI/Swagger em ferramentas usáveis. Analisa endpoints, gera definições estruturadas de ferramentas e roteia chamadas para APIs REST, permitindo agentes de IA interagirem com qualquer serviço baseado em OpenAPI sem codificação manual.

Instalação

$npx convez-ai bbonnin/openapi-to-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
4
Acompanhando
0
Saúde
42%
Último commit
há 11 meses
Versão
—
Issues abertas
1
Contribuidores
1

Casos de uso

  • Integrar APIs REST com agentes Claude sem criar tools manualmente
  • Expor infraestruturas e serviços como ferramentas MCP automaticamente
  • Acelerar desenvolvimento de assistentes que precisam consumir APIs

Veredito

Solução prática para conectar qualquer API OpenAPI ao ecossistema MCP sem boilerplate. Bem implementada em Java, com exemplo funcional, mas exige familiaridade com OpenAPI specs e deploy de servidor Java.

README

A tradução para o português deste README ainda está na fila.

OpenApi MCP Server

OpenApiMCPServer is an MCP server that automatically converts any OpenAPI/Swagger specification into a set of usable MCP tools.

It analyzes all API endpoints, generates structured tool definitions, and routes tool calls to the underlying REST API. This allows AI agents to interact with any OpenAPI-based service instantly, without manual tool coding.

Modules

There are several modules:

  • openapi-mcp-server: the application that is a MCP server providing the tools defined in an OpenAPI definition (provided as a local file or an HTTP endpoint)

    • This server dynamically loads the Swagger content and provides the functions of the API through the MCP protocol, so they can be used in a generative AI architecture without recoding anything
    • At startup: MCP Server Startup
    • At runtime: Usage
  • openapi-mcp-example: a simple example divided in two parts

    • In api package : a fake infrastructure API for managing virtual machines. The API will be invoked by the OpenAPI MCP Server
    • In assistant package : an assistant with a simple chat that will use the infrastructure API through the MCP server accessing the API

Run

MCP Server

To start the MCP Server

java -jar $PATH_TO_JAR/openapi-mcp-server.jar --openapi.location=<swagger file or URL>

Example

Example

Ver o original no GitHub

Bom para

Relacionados