MCP-Anything

Beschreibe, was du willst. Erhalte einen produktionsreifen MCP-Server.

MCP-Anything verwandelt jede Datenquelle in einen vollständig implementierten MCP-Server – basierend auf einer prägnanten Beschreibung in natürlicher Sprache, was Agenten tun können sollen. Es funktioniert auch direkt mit Codebasen, OpenAPI-Spezifikationen, gRPC-Protos und GraphQL-Schemas. Zwei Modi, ein Tool.

Schnellstart

1. Installieren

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

2. Briefing schreiben — beschreibe deine Domäne und verweise auf deine Datenquelle

# 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. Erstellen

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

4. Ausführen

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

Das ist alles. Du hast jetzt einen laufenden MCP-Server. Füge ihn deinem Agenten hinzu:

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

Related MCP server: mcpify

Zwei Modi

build — Briefing-gesteuert (empfohlen)

Das LLM liest dein Briefing, gruppiert verwandte Operationen in ergonomische Tools, schreibt Agenten-optimierte Beschreibungen und generiert das vollständige Server-Paket, einschließlich eines SKILL.md-Agentenleitfadens und einer Testumgebung.

generate — Codebasis-Scanner (kein Briefing erforderlich)

Verweise auf Quellcode oder eine Spezifikations-URL. Statische Erkennung, kein LLM erforderlich.

# 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

Was du erhältst

Beide Modi erzeugen ein vollständiges, per pip installierbares Paket:

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 ist das wichtigste Ergebnis. Es ist ein strukturiertes Dokument, das für KI-Agenten geschrieben wurde – nicht für Menschen – und jedes Tool mit seinen Parametern, Betriebsmodi, Anwendungsrezepten, Fallstricken und Anti-Patterns auflistet. Agenten lesen es, bevor sie Aufrufe tätigen, was Halluzinationen und Missbrauch drastisch reduziert.

Wie Tools entworfen werden

Das LLM folgt automatisch den MCP-Designregeln von 2026:

CRUD gruppieren. Drei oder mehr Operationen auf derselben Ressource werden zu einem einzigen manage_X(operation=...)-Tool. Weniger Tools, breitere Abdeckung, einfacher für Agenten zu verwenden.

Vollständiger Lebenszyklus. Die Tool-Design-Phase liest deine Anwendungsfälle und bildet sie auf die vollständige API-Abdeckung ab – nicht nur den Idealfall. Erstellen, Lesen, Aktualisieren, Löschen, Auflisten und alle Lebenszyklusübergänge (bestätigen, erfassen, abbrechen, abschließen, ungültig machen) sind enthalten.

Kompakt + ausführlich. Jedes Tool hat ein verbose-Flag. Standardmäßig werden nur die wesentlichen Felder zurückgegeben. Übergebe verbose=true, um die vollständige API-Antwort mit Metadaten zu erhalten.

Discovery-Endpunkt. Jeder Server stellt GET /.well-known/mcp bereit, das alle Tools und deren Offenlegungsstufen auflistet.

Konkretes Beispiel: Stripe

Das offizielle Stripe-Agent-Toolkit liefert 15 flache Tools, die nur Erstellungs- und Listenoperationen abdecken. Keine Updates, keine Löschungen, kein Lebenszyklus für Zahlungsabsichten, keine Checkout-Sitzungen, keine Gutscheine.

Wenn man mcp-anything auf die Stripe-OpenAPI-Spezifikation mit einem 41-Punkte-Briefing anwendet:

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

13 Tools, 100% Briefing-Abdeckung, 10+ Funktionen, die im offiziellen Toolkit fehlen.

Konkretes Beispiel: GitHub

Der offizielle GitHub-MCP-Server ist ein von Hand gebautes Go-Projekt. Der Bau dauerte Monate.

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

22 Tools decken dieselben 51 Operationen ab – eine Reduzierung der Oberfläche um 57% ohne Verlust an Funktionalität. Die Gruppierung (manage_repository, manage_issue, manage_pull_request usw.) ist das, was Agenten tatsächlich bevorzugen.

Siehe examples/github-server/ für das vollständig generierte Ergebnis.

Ausgabe-Ziele

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

Transport

stdio (Standard): Server läuft als lokaler Subprozess.

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

HTTP (empfohlen für geteilte/entfernte Nutzung):

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

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

HTTP ermöglicht es dir, einmal bereitzustellen und dich von jeder Agentensitzung, CI-Pipeline oder jedem Teammitglied aus zu verbinden.

Framework-Unterstützung (Generate-Modus)

27 Quelltypen über 8 Ökosysteme hinweg. Statische Erkennung, kein LLM erforderlich.

Scoping

Steuere, welche Funktionen offengelegt werden, ohne den generierten Code zu bearbeiten.

# 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

Roadmap

Siehe ROADMAP.md für die vollständige Roadmap. Siehe CONTRIBUTING.md, um einen Beitrag zu leisten.

Star History

Hör auf, MCP-Server von Hand zu schreiben.