
开源 mock MCP server 发布,无需真实服务器即可测试客户端和 agent
来源标题:Open-source mock MCP server to test clients and agents without real servers
开源项目 mcp-mock 提供模拟 MCP 服务器,用于集成测试客户端和 agent,无需连接真实服务器。它兼容 2024-11-05 至 2026-07-28 的所有规范版本,官方 SDK 无法区分它与真实服务器,工具返回确定性数据,并支持通过请求强制触发指定答案、错误或 HTTP 故障。项目还提供免费公共实例 public.mcp-mock.com,无需安装、注册或 API key。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
一个用于集成测试的 mock MCP server。把你的 MCP 客户端指向它,代码不用改。
mcp-mock 对 Model Context Protocol 的实现足够忠实,官方 SDK 无法把它和真正的服务器区分开来,覆盖从 2024-11-05 到 2026-07-28 的每一个规范修订版。它的工具返回确定性的、可信的数据,测试可以直接从请求本身强制指定任何应答、错误或 HTTP 失败,无需事先注册任何东西。
⚡ 零安装:在 public.mcp-mock.com 上运行着一个免费的公共实例。把你的 MCP 客户端指向 https://public.mcp-mock.com/mcp,几秒钟就能开始;无需下载、无需注册、无需 API key。
把你的客户端指向免费的公共实例 https://public.mcp-mock.com/mcp:
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client"; const client = new Client({ name: "my-app", version: "1.0.0" }); await client.connect(new StreamableHTTPClientTransport(new URL("https://public.mcp-mock.com/mcp"))); const result = await client.callTool({ name: "get_weather", arguments: { city: "Madrid" } }); // result.structuredContent → { city: "Madrid", temperature: 14, conditions: "thunderstorm", … } // 同样的调用,同样的字节,每次都是,在任何机器上。
自己运行
用于 CI、离线工作,或者固定到某个确切的发布版本,自己运行它,并使用 http://localhost:3000/mcp:
docker run --rm -p 3000:3000 ghcr.io/axium-lab/mcp-mock:0.1.0
可用的 tag 见 Docker 一节。或者从本仓库的克隆开始:
bun install bun start # 或者,不使用 Bun:npm install && npm run start:node (Node 22.18+)
端点
每个端点都在公共实例 https://public.mcp-mock.com 和你自己的实例(默认 http://localhost:3000)上提供。
固定版本的端点,是用来测试当服务器只支持一个修订版时你的客户端会怎么做——这一点在真实服务器上很难复现。
工具
22 个工具,在每个修订版上都按这个顺序列出。
真实计算:echo、add、calculate(一个安全的算术解析器)、transform_text、text_stats、sort_list、convert_units、hash_text、date_diff、color_swatch(一张真实的 PNG)和 simulate_work(在步骤之间等待;用于进度、超时、取消和任务)。
虚构世界:数据由规范化参数的哈希派生而来,所以同样的调用总是返回同样的数据,不同的调用返回不同的、内部一致的数据(公制和英制相互吻合,货币换算可以往返,3 天预报是 7 天预报的开头)。
参数在哈希和匹配之前会被规范化:" madrid " 和 "Madrid" 是同一个城市。结果使用每一种内容类型:文本、带输出 schema 的结构化内容、图像、resource_link 和嵌入资源。
delete_file 在 2026-07-28 上通过多轮往返请求要求确认(实际上什么都不会被删除)。
资源:file:///etc/app/config.json、file:///docs/README.md、file:///data/report.csv、file:///images/logo.png(一个二进制 blob),以及模板 weather://{city}、user://{user_id} 和 file:///{path},都取自与工具相同的虚构世界。
提示:summarize、code_review 和 weather_report,最后一个把该城市的天气作为资源嵌入。
从测试中控制应答
每个请求都携带它自己的应答必须是什么:相同的请求总是得到相同的应答,请求之间不共享任何东西。
await client.callTool({ name: "get_weather", arguments: { city: "Madrid" }, _meta: { "com.mcp-mock/response": { structuredContent: { city: "Madrid", temperature: 40 } } }, });
忠实于每个修订版
修订版之间的差异在传输层上也同样体现,例如:
mock 发送的每条消息都在其测试套件中对照其修订版的官方 schema.json 进行验证,每个端点都通过官方 TypeScript SDK 作为客户端进行演练。
在 2026-07-28 上,mock 还提供多轮往返请求、通过 SSE 的进度、通过关闭流实现的取消、subscriptions/listen 以及 tasks 扩展(io.modelcontextprotocol/tasks)。旧版修订版在不使用会话的情况下提供服务,这是规范允许的,因此它们在请求之间不保留任何状态。
授权按 URL 选择启用:/protected/ 下的一切都需要 bearer token,其他一切保持开放。mock 是它自己的授权服务器,位于同一 origin:
官方 SDK 的 OAuth 流程可以端到端地对它运行。code 和 token 用固定的公开密钥签名,且不是一次性的:这是一个测试替身,不是供真实用户使用的授权服务器。
每个发布版本都会向 GitHub Container Registry 发布一个镜像,用于 linux/amd64 和 linux/arm64。拉取无需登录:
docker pull ghcr.io/axium-lab/mcp-mock:0.1.0
Tag 指向 0.1.0 那个确切的发布版本。在 CI 中固定用这个,这样你的测试就不会在你脚下变化。 0.1 0.1 的最新补丁版本。 latest 最新的发布版本。
容器监听 3000 端口,并通过 /health 向 Docker 报告其状态。要在另一个端口上提供服务,两边都要改:
docker run --rm -p 8080:8080 -e MCP_MOCK_PORT=8080 ghcr.io/axium-lab/mcp-mock:0.1.0
配置
变量 默认值 含义 MCP_MOCK_PORT(或 PORT) 3000 监听的端口。
尚不支持
stdio、Origin 头校验,以及旧版修订版上的会话。在 Discussions 中告诉我们你需要什么。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。