Mockmcp

MockMCP

エージェントのプロトタイピング向けに、現実的な偽データを返すホスト型 MCP エンドポイントです。URL を 1 つ貼り付けるだけで、セットアップは不要です。

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}}}'

クライアントを接続する

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 — Settings → Connectors → Add custom connector → URL として https://mockmcp.io/mcp を貼り付けます。

mcp-remote プロキシは不要です。3 つのクライアントはすべて、Streamable HTTP をネイティブに使用できます。

ツール

ツール	機能
list_users	モックユーザーのページネーション付き一覧
get_user	id または seed で指定した 1 人のモックユーザー
create_user	モックユーザーを作成します（永続化されません）
list_products	モック商品のページネーション付き一覧
get_product	1 件のモック商品
list_orders	ステータスで絞り込み可能なモック注文
get_order	1 件のモック注文
create_order	モック注文を作成します（永続化されません）
list_events	モック分析イベント
create_event	モックイベントを記録します
send_email	偽の成功レスポンスを返します。メールは送信されません
search_knowledge_base	順位付けされた結果を返すモック KB 検索

すべてのデータは入力をシードとして生成されます。同じ入力なら、同じ出力になります。

制限

ハッシュ化された IP + User-Agent フィンガープリントごとの無料枠：

• 1 分あたり 30 リクエスト
• 1 日あたり 500 リクエスト

上限に達しましたか？有料プランの開始時にアクセスできるよう、mockmcp.io/waitlist でメールアドレスを登録してください。

429 レスポンスには、upgrade_url と retry_after_seconds を含む構造化された JSON-RPC エラーが付属します。成功したレスポンスにはすべて、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 — シードによる決定論的な偽データ
• @upstash/ratelimit + @upstash/redis — スライディングウィンドウ方式のレート制限
• zod — ツール入力の検証

デプロイ（フォークする場合）

Node 20+ が対象です。ビルドと起動は nixpacks.toml で固定されています。ヘルスチェックと再起動ポリシーは railway.json で設定されています。

1. このリポジトリをフォークし、GitHub にプッシュします。
2. Railway → New Project → Deploy from GitHub → フォークしたリポジトリを選択します。
3. Railway → Variables で環境変数を追加します。

変数	備考
UPSTASH_REDIS_REST_URL	upstash.com の無料枠で取得できます
UPSTASH_REDIS_REST_TOKEN	上記の URL と組み合わせて使用します
PORT	Railway が自動的に設定します

4. Railway のサービス → Settings → Networking → Custom Domain → ドメインを貼り付け、DNS の手順に従います。

ヘルスチェック

GET /health は {"ok":true} を返します。Railway はデプロイ中にこのエンドポイントへ ping を送ります。

ウェイトリストへの登録

POST /api/waitlist は、登録ごとに構造化された JSON 行を記録します。

{"event":"waitlist_signup","email":"[email protected]","at":"2026-04-24T19:33:06.396Z"}

railway logs | grep waitlist_signup で検索できます。設計上、ストレージは使用しません。有料プランの提供開始時に、Resend、Tally への転送、または DB に置き換えてください。

ライセンス

MIT — LICENSE を参照してください。