MockMCP

Размещенный MCP-эндпоинт, возвращающий реалистичные фиктивные данные для прототипирования агентов. Вставьте один URL, никакой настройки.

Работает на mockmcp.io — https://mockmcp.io/mcp

Создано для разработчиков, которые хотят прототипировать рабочие процессы агентов без подключения бэкенда, написания фикстур или запуска локального MCP-сервера. 12 готовых инструментов, охватывающих сценарии из большинства руководств по агентам.

Попробуйте

# Initialize a session and get back a session id
curl -i -X POST https://mockmcp.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'

# Use the Mcp-Session-Id header in subsequent calls:
curl -X POST https://mockmcp.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <paste-id-here>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_users","arguments":{"limit":3}}}'

Related MCP server: APIbase

Подключите ваш клиент

Claude Code

claude mcp add --transport http mockmcp https://mockmcp.io/mcp

Cursor — добавьте в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mockmcp": {
      "url": "https://mockmcp.io/mcp"
    }
  }
}

Claude Desktop — Настройки → Коннекторы → Добавить пользовательский коннектор → вставьте https://mockmcp.io/mcp в качестве URL.

Прокси mcp-remote не требуется. Все три клиента поддерживают Streamable HTTP нативно.

Инструменты

Все данные генерируются на основе ваших входных параметров — одинаковый ввод, одинаковый вывод.

Ограничения

Бесплатный уровень, на каждый хешированный отпечаток IP + User-Agent:

• 30 запросов в минуту

• 500 запросов в день

Уперлись в лимит? Оставьте свой email на mockmcp.io/waitlist для доступа к платному уровню после его запуска.

Ответы 429 содержат структурированную ошибку JSON-RPC с полями upgrade_url и retry_after_seconds. Каждый успешный ответ содержит заголовки X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset и X-RateLimit-Scope.

Запуск локально

npm install
npm run dev

Сервер слушает на http://localhost:3000. MCP-эндпоинт по адресу /mcp. Без переменных окружения Upstash ограничение скорости переключается на хранилище в памяти (на процесс, подходит для разработки).

Стек

• @modelcontextprotocol/sdk — MCP-сервер + транспорт Streamable HTTP

• Чистый Node http — без накладных расходов фреймворка, корректное завершение работы

• @faker-js/faker — детерминированные фиктивные данные через seed

• @upstash/ratelimit + @upstash/redis — ограничение скорости по скользящему окну

• zod — валидация входных данных инструментов

Развертывание (для форков)

Требуется Node 20+. Сборка и запуск закреплены через nixpacks.toml; проверки работоспособности и политика перезапуска через railway.json.

1. Сделайте форк этого репозитория, запушьте на GitHub.

2. Railway → New Project → Deploy from GitHub → выберите ваш форк.

3. Добавьте переменные окружения в Railway → Variables:

4. Сервис Railway → Settings → Networking → Custom Domain → вставьте ваш домен → следуйте инструкциям DNS.

Проверка работоспособности

GET /health возвращает {"ok":true}. Railway пингует это во время развертывания.

Регистрация в списке ожидания

POST /api/waitlist записывает структурированную строку JSON для каждой регистрации:

{"event":"waitlist_signup","email":"alice@example.com","at":"2026-04-24T19:33:06.396Z"}

Ищите их через railway logs | grep waitlist_signup. По дизайну без хранения — замените на Resend, пересылку в Tally или БД, когда платный уровень будет запущен.

Лицензия

MIT — см. LICENSE.