convez.ai
PluginIntegração & APIsIniciante
Work90210

APIFold

Work90210/APIFold

Converta APIs REST em servidores MCP com um comando, sem código

Ver no GitHub
BomPluginScore · de 0 a 100

Transforma qualquer especificação OpenAPI 3.x ou Swagger 2.x em um servidor MCP pronto para produção, sem código. Claude, Cursor e outros clientes MCP se conectam imediatamente e executam chamadas HTTP reais contra APIs upstream com credenciais armazenadas de forma segura.

Instalação

$npx convez-ai Work90210/APIFold

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
13
Forks
3
Acompanhando
1
Saúde
100%
Último commit
há 4 meses
Versão
—
Issues abertas
18
Contribuidores
5

Casos de uso

  • Conectar Claude ou Cursor a APIs externas (Stripe, GitHub, Slack, etc) sem desenvolvimento
  • Criar agentes IA que interagem com sistemas legados via suas APIs públicas
  • Disponibilizar múltiplas APIs como ferramentas unificadas em uma única sessão MCP

Veredito

Solução pragmática que elimina camadas de integração manual. Suporta OAuth 2.0, controle de acesso por ferramenta e analytics — adequado para equipes que precisam conectar agentes IA a ecossistemas de APIs existentes rapidamente.

README

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

CI License Transformer npm Node

APIFold reads an OpenAPI 3.x or Swagger 2.x specification and generates a live, production-ready MCP server endpoint. AI agents — Claude, Cursor, Copilot, or any MCP-compatible client — can connect immediately. Tool calls execute real HTTP requests to real upstream APIs with securely stored credentials. No stubs, no mocks, no glue code.

Quick Start

CLI (fastest)

npx apifold serve ./your-openapi-spec.yaml --base-url https://api.example.com

One command. Your spec becomes a running MCP server with SSE transport on localhost:3000. Connect Claude or Cursor immediately.

From the API Registry

npx apifold serve --registry stripe --base-url https://api.stripe.com

Ships with 8 pre-configured API specs: Stripe, GitHub, Slack, HubSpot, Twilio, OpenAI, Notion, and Petstore.

Hosted Platform

  1. Sign up at apifold.dev
  2. Import a spec (URL, file upload, or browse the registry)
  3. Copy the connection snippet into Claude Desktop or Cursor
  4. Your MCP server is live with a unique endpoint URL

Features

  • OpenAPI 3.x + Swagger 2.0 — auto-converts Swagger 2.0 specs transparently
  • CLI tool — npx apifold serve for zero-config local MCP servers
  • API registry — one-click deploy from 8 curated API specs
  • OAuth 2.0 — Authorization Code (PKCE), Client Credentials, 8 provider presets, auto token refresh
  • Access profiles — tool-level permissions (Read Only / Read-Write / Full Access)
  • Analytics — call volume, latency percentiles, error breakdown, usage quotas
  • Custom domains — use mcp.yourcompany.com with DNS verification
  • Unique endpoint IDs — cryptographic, unguessable URLs per server
  • SSE + Streamable HTTP — both MCP transport modes supported
  • Vault encryption — AES-256-GCM for all stored credentials
  • SSRF protection — DNS pinning, redirect blocking, private IP rejection

CLI

npm install -g @apifold/cli
CommandDescription
apifold serve <spec>Start an MCP server from an OpenAPI spec
apifold serve --registry stripeStart from a registry spec
apifold transform <spec>Output MCP tool definitions as JSON
apifold validate <spec>Parse-only validation with warnings
apifold init [spec]Generate an apifold.config.yaml template

Config file

# apifold.config.yaml
spec: ./openapi/stripe.yaml
port: 3001
transport: sse
baseUrl: https://api.stripe.com
auth:
  type: bearer
  token: ${STRIPE_API_KEY}
filters:
  tags: [payments, customers]
  methods: [get, post]

Self-Hosting

Development

git clone https://github.com/Work90210/APIFold.git
cd APIFold
pnpm install
cp .env.example .env
docker compose -f infra/docker-compose.dev.yml up -d
pnpm dev

Open http://localhost:3000 to access the dashboard.

Production

cp .env.example .env
# Edit .env with your production values
docker compose -f infra/docker-compose.yml up -d

Using the Transformer Library

The core conversion logic is a standalone MIT-licensed npm package:

npm install @apifold/transformer
import { parseSpec, transformSpec, autoConvert } from "@apifold/transformer";

// Auto-convert Swagger 2.0 if needed
const { spec } = await autoConvert(rawSpec);

// Parse and transform
const parsed = parseSpec({ spec });
const { tools } = transformSpec({ spec: parsed.spec });
// tools = MCPToolDefinition[] ready for any MCP server

Architecture

graph LR
    Spec["OpenAPI / Swagger\nSpec"] --> Transformer

    subgraph MT["APIFold"]
        Transformer["Transformer\n(MIT lib)"]
        Transformer --> Runtime["Runtime\nExpress + SSE"]
        Web["Web App\nNext.js"] --> DB["Postgres 16\nRedis 7"]
        Runtime --> DB
        CLI["CLI Tool\nnpx apifold"]
        Registry["API Registry\n8 specs"]
    end

    Runtime --> Upstream["Upstream API\n(Stripe, GitHub, etc.)"]
    Agent["AI Agent\nClaude, Cursor,\nCopilot, etc."] -- "MCP / SSE" --> Runtime
ComponentPathDescription
Transformerpackages/transformerOpenAPI to MCP conversion. Pure functions. MIT licensed.
Runtimeapps/runtimeExpress MCP server with SSE/HTTP, OAuth token refresh, access profiles.
Web Appapps/webNext.js dashboard. Import specs, manage credentials, analytics, custom domains.
CLIapps/cliStandalone CLI tool. npx apifold serve for local MCP servers.
Registrypackages/registryCurated catalog of 8 validated API specs with one-click deploy.
Typespackages/typesShared TypeScript type definitions.
UIpackages/uiDesign system and component library.

Available Commands

CommandDescription
pnpm devStart all services with hot-reload
pnpm buildBuild all packages
pnpm testRun tests
pnpm lintLint all packages
pnpm typecheckType-check all packages
pnpm formatFormat all files with Prettier
pnpm db:migrateRun database migrations
pnpm db:studioOpen Drizzle Studio

Contributing

All code contributions must go through a pull request and be approved before merging. See the contribution guide.

Want to add an API to the registry? See packages/registry/CONTRIBUTING.md.

Security

For security issues, please refer to our security policy. Do not post security vulnerabilities as public GitHub issues.

License

Ver o original no GitHub

Bom para

Relacionados