CopilotKit/aimock

Mock everything your AI app talks to — LLM APIs, MCP, A2A, AG-UI, vector DBs, search. One package, one port, zero dependencies.

What it solves

测试 AI 应用程序往往因依赖实时 LLM API 与其他 AI 服务而成本高、速度慢且结果不确定。aimock 提供完整的模拟基础设施，让开发者能在本地模拟这些服务，省去真实 API 密钥、网络调用以及实时生产 API 的费用。

How it works

aimock 作为本地服务器，模仿多家 AI 供应商的 API 接口。只要将 AI SDK（例如 OpenAI）的 BASE_URL 改为指向 aimock 服务器，应用程序就会把请求发送到模拟服务器而非真实供应商。它使用「fixtures」——预先定义的请求-响应配对，返回确定性的结果。它亦提供录制与重放模式，能代理真实 API 调用并将其保存为 fixtures，以供未来确定性重放。

Who it’s for

开发 AI 代理、LLM 驱动的应用程序与多模态 AI 工具的开发者，需要可靠、快速且具成本效益的方式来执行单元测试与端到端测试，而不必触及实时生产端点。

Highlights

  • Broad Provider Support: 模拟 13 家供应商的 15 种 API 接口，包括 OpenAI、Claude、Gemini、Bedrock、Azure、Vertex AI 与 Ollama。
  • Multimodal Capabilities: 支持图像生成（DALL‑E、Imagen）、文字转语音、音频转录与视频生成的模拟。
  • Protocol Mocking: 除了 LLM，还模拟 MCP 工具、A2A（Agent‑to‑Agent）协议、AG‑UI 事件流以及向量数据库（Pinecone、Qdrant、ChromaDB）。
  • Deterministic Testing: 包含具时间感知的录制与重放功能，以及多轮对话匹配。
  • Chaos Testing: 能模拟 500 错误、JSON 格式错误与流中断，以测试应用程序的韧性。
  • Scaling & Integration: 提供 Docker/Helm 图表供 CI/CD 使用、Vitest/Jest 插件，以及 GitHub Action，让测试流程无缝集成。