MCP-Anything

Describe lo que quieres. Obtén un servidor MCP listo para producción.

MCP-Anything convierte cualquier fuente de datos en un servidor MCP completamente implementado, a partir de un resumen en lenguaje sencillo que describe lo que los agentes deberían ser capaces de hacer. También funciona directamente desde bases de código, especificaciones OpenAPI, protos de gRPC y esquemas de GraphQL. Dos modos, una sola herramienta.

Inicio rápido

1. Instalar

pip install mcp-anything
export ANTHROPIC_API_KEY=sk-...

2. Escribir un resumen — describe tu dominio y apunta a tu fuente de datos

# my-api.yaml
server_name: payments-mcp
domain_description: >
  A payment API for managing customers, invoices, and subscriptions.
use_cases:
  - "Create a customer with email and name"
  - "Issue an invoice and send it to the customer"
  - "Create and cancel subscriptions"
  - "Issue refunds"
data_source_path: ./openapi.json   # local file or URL
data_source_kind: openapi          # openapi | graphql | grpc
auth_method: bearer_token
backend_target: fastmcp

3. Construir

mcp-anything build --brief my-api.yaml -o ./my-mcp-server

4. Ejecutar

cd my-mcp-server
pip install -e .
python -m mcp_payments_mcp.server

Eso es todo. Ahora tienes un servidor MCP en ejecución. Añádelo a tu agente:

{
  "mcpServers": {
    "payments": { "command": "python", "args": ["-m", "mcp_payments_mcp.server"] }
  }
}

Related MCP server: mcpify

Dos modos

build — basado en resumen (recomendado)

El LLM lee tu resumen, agrupa operaciones relacionadas en herramientas ergonómicas, escribe descripciones optimizadas para agentes y genera el paquete completo del servidor, incluyendo una guía para agentes SKILL.md y un banco de pruebas.

generate — escáner de base de código (no requiere resumen)

Apunta al código fuente o a una URL de especificación. Detección estática, no se necesita LLM.

# From a local codebase
mcp-anything generate /path/to/your/app

# From a URL (OpenAPI, GraphQL, gRPC)
mcp-anything generate https://api.example.com/openapi.json

Qué obtienes

Ambos modos producen un paquete completo instalable mediante pip:

my-mcp-server/
├── mcp_<name>/
│   ├── server.py          # FastMCP server (stdio or HTTP)
│   ├── tools/             # One file per tool, HTTP calls via httpx
│   ├── discovery.py       # GET /.well-known/mcp
│   └── telemetry.py       # Anonymised per-call logging
├── SKILL.md               # Agent-readable usage guide (recipes, gotchas, anti-patterns)
├── quick_queries.json     # Eval set derived from your use cases
├── eval_cases.json        # LLM-generated evaluation cases
├── conformance_report.json
├── Dockerfile
└── pyproject.toml

SKILL.md es el resultado clave. Es un documento estructurado escrito para agentes de IA —no para humanos— que enumera cada herramienta con sus parámetros, modos de operación, recetas de uso, advertencias y antipatrones. Los agentes lo leen antes de realizar cualquier llamada, lo que reduce drásticamente las alucinaciones y el uso indebido.

Cómo se diseñan las herramientas

El LLM sigue automáticamente las reglas de diseño de MCP 2026:

Agrupar CRUD. Tres o más operaciones sobre el mismo recurso se convierten en una única herramienta manage_X(operation=...). Menos herramientas, mayor cobertura, más fácil de usar para los agentes.

Ciclo de vida completo. La fase de diseño de la herramienta lee tus casos de uso y los mapea a una cobertura completa de la API, no solo al camino feliz. Se incluyen creación, lectura, actualización, eliminación, listado y cualquier transición de ciclo de vida (confirmar, capturar, cancelar, finalizar, anular).

Compacto + detallado. Cada herramienta tiene un flag verbose. Por defecto, devuelve solo los campos esenciales. Pasa verbose=true para obtener la respuesta completa de la API con metadatos.

Endpoint de descubrimiento. Cada servidor expone GET /.well-known/mcp listando todas las herramientas y sus niveles de divulgación.

Ejemplo concreto: Stripe

El kit de herramientas oficial para agentes de Stripe incluye 15 herramientas planas que cubren solo operaciones de creación y listado. Sin actualizaciones, sin eliminaciones, sin ciclo de vida de intención de pago, sin sesiones de checkout, sin cupones.

Ejecutando mcp-anything contra la especificación OpenAPI de Stripe con un resumen de 41 elementos:

mcp-anything build --brief stripe.yaml -o ./stripe-mcp --target fastmcp

13 herramientas, 100% de cobertura del resumen, más de 10 capacidades ausentes en el kit de herramientas oficial.

Ejemplo concreto: GitHub

El servidor MCP oficial de GitHub es un proyecto en Go construido a mano. Construirlo llevó meses.

mcp-anything build --brief github.yaml -o ./github-mcp

22 herramientas cubren las mismas 51 operaciones — una reducción del 57% en la superficie sin pérdida de capacidad. La agrupación (manage_repository, manage_issue, manage_pull_request, etc.) es lo que los agentes realmente prefieren.

Consulta examples/github-server/ para ver el resultado generado completo.

Objetivos de salida

mcp-anything build --brief my-api.yaml --target mcp-use
mcp-anything generate /path/to/app --target mcp-use

Transporte

stdio (por defecto): el servidor se ejecuta como un subproceso local.

{
  "mcpServers": {
    "my-app": { "command": "mcp-my-app", "args": [] }
  }
}

HTTP (recomendado para uso compartido/remoto):

mcp-anything generate /path/to/app --transport http
# server runs at http://localhost:8000/sse

{
  "mcpServers": {
    "my-app": { "url": "http://localhost:8000/sse" }
  }
}

HTTP te permite desplegar una vez y conectar desde cualquier sesión de agente, pipeline de CI o miembro del equipo.

Soporte de frameworks (modo generate)

27 tipos de fuentes en 8 ecosistemas. Detección estática, no se requiere LLM.

Alcance

Controla qué capacidades se exponen sin editar el código generado.

# Include / exclude by glob
mcp-anything generate ./my-app --include "/api/v2/*" --exclude "/internal/*"

# Review mode: pause after analysis, curate scope.yaml, then resume
mcp-anything generate ./my-app --review
vim mcp-my-app-server/scope.yaml
mcp-anything generate ./my-app --resume

# Reusable scope file
mcp-anything generate ./my-app --scope-file ./mcp-scope.yaml

Hoja de ruta

Consulta ROADMAP.md para la hoja de ruta completa. Consulta CONTRIBUTING.md para contribuir.

Historial de estrellas

Deja de escribir servidores MCP a mano.