AIMock — Mock LLM, MCP, A2A, Vector APIs

简介

AIMock 是一个用于 AI 应用测试的“一站式 mock 服务器”：可模拟 LLM provider、MCP 工具、A2A agent、向量/搜索 API 等，让测试不再直连真实付费端点并降低波动与费用。

• 适合谁： 需要可复现 fixture、record/replay、并希望一端口统一 mock 的 Agent 测试团队
• 可搭配： Node.js 项目、Jest/Vitest 等测试框架、通过 OPENAI_BASE_URL 对接 OpenAI 兼容 SDK
• 准备时间： 10 分钟

实战建议

• 一个端口即可 mock 多类能力（LLM API、MCP、A2A、向量/搜索/重排等）
• 官方文档列出 12 个 LLM provider 支持，并可模拟 streaming 行为
• GitHub stars / forks（已核验）：见「来源与感谢」

AIMock 的收益非常直接：一次避免 flaky 测试或“意外烧 token”就值回票价。

建议按三步使用：

1. 先用 llmock（fixture 驱动）或用 --config 跑全套 mock。
2. 通过 OPENAI_BASE_URL 把 SDK 指向 mock（某些 SDK 仍需要一个占位 key）。
3. 需要时先录一次真实 trace，之后在 CI 里长期稳定回放。

两个实践护栏：

• fixture 进版本库，像代码一样审查。
• CI 加断言：如果测试误连真实端点（base URL 没 patch）就直接失败。

FAQ

它能 mock 哪些东西？ 答：LLM API + MCP/A2A 等协议，以及向量库/搜索/重排等常见基础设施。

能录制真实响应吗？ 答：可以，支持 record & replay，把真实响应保存为可复现 fixture。

怎么安全接入？ 答：测试里用环境变量 patch base URL，并在 CI 加护栏防止误连真实端点。