Mockmcp

MockMCP

托管的 MCP 端点，可为原型开发中的 Agent 返回逼真的虚假数据。粘贴一个 URL，无需任何设置。

已上线：mockmcp.io — https://mockmcp.io/mcp

专为想要构建 Agent 工作流原型，却不想连接后端、编写测试数据或启动本地 MCP 服务的开发者打造。内置 12 个工具，涵盖大多数 Agent 教程中的场景。

试用

# 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 — 设置 → 连接器 → 添加自定义连接器 → 将 https://mockmcp.io/mcp 粘贴为 URL。

无需 mcp-remote 代理。这三个客户端都原生支持 Streamable HTTP。

工具

工具	功能
list_users	分页列出模拟用户
get_user	按 id 或 seed 获取单个模拟用户
create_user	创建模拟用户（不持久化）
list_products	分页列出模拟商品
get_product	获取单个模拟商品
list_orders	列出模拟订单，可选按状态筛选
get_order	获取单个模拟订单
create_order	创建模拟订单（不持久化）
list_events	列出模拟分析事件
create_event	记录模拟事件
send_email	返回虚假的成功结果，不会实际发送邮件
search_knowledge_base	搜索模拟知识库并返回排名结果

所有数据都根据你的输入生成种子——相同的输入会得到相同的输出。

限制

免费套餐按经过哈希处理的 IP + User-Agent 指纹计算：

• 每分钟 30 次请求
• 每天 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. Fork 此仓库并推送到 GitHub。
2. Railway → 新建项目 → 从 GitHub 部署 → 选择你的 fork。
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 会在部署期间对其发送请求。

等候名单注册

POST /api/waitlist 会为每次注册记录一行结构化 JSON：

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

使用 railway logs | grep waitlist_signup 搜索日志。此设计无需存储——付费套餐上线后，可替换为 Resend、转发到 Tally，或接入数据库。

许可证

MIT — 参见 LICENSE。