mcp2api

Любой MCP → обычный HTTP за 15 секунд. Один файл, ноль билда.

npx -y github/megamen32/mcp2api -- --command "npx @anthropic-ai/mcp-server-fetch" --port 8080

Зачем

MCP — крутой протокол. Но есть проблема: не все ИИ умеют подключать MCP напрямую.

Claude Desktop подключает. Cursor подключает. А что если ты хочешь:

• Дать ChatGPT Custom GPT доступ к MCP-тулам? ChatGPT не умеет в MCP.

• Подключить MCP к Telegram-боту? Там только HTTP.

• Использовать MCP-инструменты в Alice, GigaChat, DeepSeek? Нет MCP-клиента.

• Дать chat.z.ai вызывать MCP? Там есть web_fetch, но нет MCP.

А curl умеют все. Любой ИИ с доступом в интернет может сделать GET-запрос.

mcp2api берёт любой MCP-сервер и превращает его инструменты в простые HTTP-ручки. Один вызов npx — и готово.

Как это решает проблему CustomGPT

У ChatGPT Custom GPT нет MCP. Но есть Actions — он умеет вызывать HTTP-эндпоинты.

1. Запускаешь mcp2api с нужным MCP-сервером:

   npx -y github/megamen32/mcp2api -- \
     --command "npx @anthropic-ai/mcp-server-fetch" \
     --port 8080 \
     --api-key your-secret

2. В настройках CustomGPT добавляешь OpenAPI-схему: http://your-server:8080/

3. Готово — Custom GPT вызывает MCP-инструменты через обычные HTTP-запросы.

GET-only режим (для агентов с web_fetch)

Некоторые ИИ-агенты не умеют POST-запросы. Только web_fetch / web_search. Для них есть --get-only:

npx -y github/megamen32/mcp2api -- \
  --command "npx @anthropic-ai/mcp-server-fetch" \
  --port 8080 \
  --get-only

В этом режиме вызов инструмента — это просто GET:

GET /tools/echo?message=hello
GET /tools/fetch?url=https://example.com
GET /tools/search?query=mcp+protocol&limit=5

Типы автоматически кастятся: "5" → 5, "true" → true.

Любой ИИ, который умеет делать web_fetch(url) — теперь может вызывать MCP-инструменты.

One-liner

# stdio (запускает MCP-сервер как процесс)
npx -y github/megamen32/mcp2api -- --command "npx @anthropic-ai/mcp-server-fetch" --port 8080

# SSE (подключается к уже запущенному MCP-серверу)
npx -y github/megamen32/mcp2api -- --transport sse --url http://localhost:3001/sse

# StreamableHTTP
npx -y github/megamen32/mcp2api -- --transport streamable-http --url http://localhost:3001/mcp

# GET-only (для агентов без POST, типа web_fetch)
npx -y github/megamen32/mcp2api -- --command "npx @anthropic-ai/mcp-server-fetch" --get-only --port 8080

Endpoints

Примеры

# Список инструментов
curl http://localhost:4321/tools

# Схема конкретного инструмента
curl http://localhost:4321/tools/fetch

# Вызов через POST (полный режим)
curl -X POST http://localhost:4321/tools/fetch \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com"}'

# Вызов через GET (работает даже в web_fetch!)
curl 'http://localhost:4321/tools/fetch?url=https://example.com'

# Через /call
curl -X POST http://localhost:4321/call \
  -H 'Content-Type: application/json' \
  -d '{"name": "fetch", "arguments": {"url": "https://example.com"}}'

Флаги

Авторизация (опционально)

npx -y github/megamen32/mcp2api -- --api-key mysecret --port 8080

Передавай Authorization: Bearer mysecret или ?api_key=mysecret.

Лицензия

MIT