convez.ai
MCP ServerIntegração & APIsIntermediário
hilothefunnydog123-coder

MCP Forge

hilothefunnydog123-coder/mcp-forge

OpenAPI → MCP server em 30 segundos, sem codegen

Ver no GitHub
InicialPluginScore · de 0 a 100

Converte qualquer especificação OpenAPI em um MCP server funcional em tempo real, sem geração de código. Claude acessa instantaneamente ferramentas tipadas para cada endpoint da sua API REST.

Instalação

$npx convez-ai hilothefunnydog123-coder/mcp-forge

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Expor APIs REST legadas para Claude sem reescrever código
  • Conectar serviços terceirizados (Stripe, Slack, etc.) como ferramentas nativas
  • Prototipagem rápida de integrações API em projetos Claude

Veredito

Solução pragmática e bem executada para o problema real de integrar APIs ao Claude sem boilerplate. A abordagem runtime-first elimina fricção, mas o suporte a $refs remotos e schemas complexos ainda é limitado — adequado para APIs maduras com specs OpenAPI 3 limpas.

README

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

mcp-forge

Turn any OpenAPI spec into a working MCP server. Point it at a spec (file or URL) and Claude instantly gets a tool for every endpoint — no codegen, no boilerplate, no hand-writing tool definitions.

npx mcp-forge ./openapi.json
# -> serving 14 tools from ./openapi.json -> https://api.example.com/v1

MCP is how Claude calls real tools. Writing an MCP server for an API you already have is tedious busywork — mcp-forge does it in one command by reading the API's own OpenAPI/Swagger spec at runtime and proxying the calls.

  • 🔌 Any REST API with an OpenAPI 3 / Swagger spec → Claude tools
  • ⚡ Runtime, zero codegen — no generated files to maintain
  • 🧭 One tool per operation, typed inputs built from the spec's parameters
  • 🔐 Pass auth headers through to the upstream API
  • 📄 JSON or YAML specs, local file or URL

Use it with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "petstore": {
      "command": "npx",
      "args": ["-y", "mcp-forge", "https://petstore3.swagger.io/api/v3/openapi.json"]
    }
  }
}

With auth + an explicit base URL:

{
  "mcpServers": {
    "myapi": {
      "command": "npx",
      "args": [
        "-y", "mcp-forge", "./openapi.yaml",
        "--base-url", "https://api.example.com/v1",
        "--header", "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}

CLI

mcp-forge <openapi-spec-file-or-url> [options]

  --base-url URL        Override the server URL (else taken from spec.servers[0])
  --header "Key: Value"  Header added to every upstream request (repeatable)
  --name NAME           MCP server name

As a library

import { loadSpec, openapiToTools, buildServer } from 'mcp-forge'
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'

const spec = await loadSpec('./openapi.json')
const tools = openapiToTools(spec) // -> ToolDef[]
const server = buildServer(tools, { baseUrl: 'https://api.example.com/v1' })
await server.connect(new StdioServerTransport())

How it works

  1. Load + parse the spec (JSON/YAML, local or remote).
  2. Walk paths × HTTP methods → one tool per operation. The tool's input schema is built from the operation's path, query, and header parameters (plus a body for request bodies).
  3. When Claude calls a tool, mcp-forge builds the real HTTP request — filling path/query/header params and the JSON body — sends it, and returns the status + response.

Scope (v1)

Supports OpenAPI 3 operations with path/query/header params and JSON request bodies, and local #/... $ref resolution. Deep/remote $refs, oneOf/allOf body schemas, and non-JSON bodies are simplified — PRs welcome.

License

MIT © 2026 Neil Gilani

Ver o original no GitHub

Bom para

Relacionados