MCP-Anything

Опишите, что вам нужно. Получите готовый к работе MCP-сервер.

MCP-Anything превращает любой источник данных в полноценно реализованный MCP-сервер — на основе краткого описания на естественном языке того, что должны уметь делать агенты. Инструмент также работает напрямую с кодовыми базами, спецификациями OpenAPI, протоколами gRPC и схемами GraphQL. Два режима, один инструмент.

Быстрый старт

1. Установка

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

2. Напишите бриф — опишите свою предметную область и укажите источник данных

# 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. Сборка

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

4. Запуск

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

Вот и всё. Теперь у вас есть работающий MCP-сервер. Добавьте его в своего агента:

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

Related MCP server: mcpify

Два режима

build — на основе брифа (рекомендуется)

LLM читает ваш бриф, группирует связанные операции в эргономичные инструменты, пишет оптимизированные для агентов описания и генерирует полный пакет сервера, включая руководство для агента SKILL.md и набор для оценки.

generate — сканер кодовой базы (бриф не требуется)

Укажите исходный код или URL спецификации. Статическое обнаружение, 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

Что вы получаете

Оба режима создают полный пакет, готовый к установке через 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 — это ключевой результат. Это структурированный документ, написанный для ИИ-агентов (а не для людей), в котором перечислены все инструменты с их параметрами, режимами работы, рецептами использования, подводными камнями и антипаттернами. Агенты читают его перед выполнением любых вызовов, что значительно снижает количество галлюцинаций и неправильного использования.

Как проектируются инструменты

LLM автоматически следует правилам проектирования MCP 2026 года:

Группировка CRUD. Три или более операций над одним и тем же ресурсом становятся единым инструментом manage_X(operation=...). Меньше инструментов, шире охват, проще для использования агентами.

Полный жизненный цикл. Фаза проектирования инструментов считывает ваши варианты использования и сопоставляет их с полным покрытием API — не только «счастливый путь». Создание, чтение, обновление, удаление, список и любые переходы жизненного цикла (подтверждение, захват, отмена, завершение, аннулирование) включены.

Компактность + подробность. Каждый инструмент имеет флаг verbose. По умолчанию он возвращает только основные поля. Передайте verbose=true, чтобы получить полный ответ API с метаданными.

Эндпоинт обнаружения. Каждый сервер предоставляет GET /.well-known/mcp, перечисляющий все инструменты и уровни их раскрытия.

Конкретный пример: Stripe

Официальный инструментарий агента Stripe поставляется с 15 плоскими инструментами, охватывающими только операции создания и списка. Никаких обновлений, удалений, жизненного цикла платежных намерений, сеансов оформления заказа или купонов.

Запуск mcp-anything для спецификации Stripe OpenAPI с брифом из 41 пункта:

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

13 инструментов, 100% покрытие брифа, 10+ возможностей, отсутствующих в официальном инструментарии.

Конкретный пример: GitHub

Официальный MCP-сервер GitHub — это проект на Go, созданный вручную. Его создание заняло месяцы.

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

22 инструмента покрывают те же 51 операцию — сокращение поверхности на 57% без потери функциональности. Группировка (manage_repository, manage_issue, manage_pull_request и т.д.) — это то, что на самом деле предпочитают агенты.

См. examples/github-server/ для полного сгенерированного вывода.

Целевые форматы вывода

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

Транспорт

stdio (по умолчанию): сервер запускается как локальный подпроцесс.

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

HTTP (рекомендуется для общего/удаленного использования):

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

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

HTTP позволяет развернуть сервер один раз и подключаться к нему из любого сеанса агента, CI-конвейера или участника команды.

Поддержка фреймворков (режим generate)

27 типов источников в 8 экосистемах. Статическое обнаружение, LLM не требуется.

Определение области видимости

Управляйте тем, какие возможности будут доступны, не редактируя сгенерированный код.

# 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.md для полной дорожной карты. См. CONTRIBUTING.md для внесения вклада.

История звезд

Хватит писать MCP-серверы вручную.