aimock

本地一键 Mock 所有 AI 依赖，测试不烧钱不联网

开源 🏷️定价信息待确认 ⚠️ 链接可跳转，访问体验不确定基础设施 🍴 复刻 82 🐛 待处理 1 👀 关注 4

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1004

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类基础设施

开发团队CopilotKit

官网地址http://aimock.copilotkit.dev

GitHubhttps://github.com/CopilotKit/aimock

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态⚠️ 链接可跳转，访问体验不确定

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-testing,aimock,llm,mcp,mock-server,openai

GitHub 星标★ 1004

上线时间2026-03-03 00:00:00

代码更新2026-11-04

仓库体积15.2 MB

本站数据更新2026-11-04

维护状态活跃

收录时间2026-09-16

浏览次数6

项目介绍

aimock 是一个面向 AI 应用开发的本地 Mock 服务器，用 TypeScript 编写，目标是让开发者在不依赖真实外部服务的情况下测试和开发 AI 应用。它把 AI 应用常见的依赖统一到一个进程、一个端口上模拟：LLM API（如 OpenAI 风格接口）、MCP（模型上下文协议）、A2A（Agent 间通信）、AG-UI（Agent 前端交互协议）、向量数据库以及搜索服务。核心价值在于解决 AI 应用测试难的问题——真实调用 LLM 又慢又贵、结果不稳定，向量库和外部搜索也难以在 CI 中稳定复现。aimock 提供零依赖的单一包，开发者只需启动本地服务，把 SDK 的 base URL 指过来即可获得可预测的响应，从而编写确定性的单元测试、集成测试，或在离线环境下开发调试。它适合需要频繁迭代 prompt、Agent 逻辑和检索链路的团队，降低对线上 API 的依赖和成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-16 · 当前星标 ★ 1004

技术标签

ai-testing llm mcp openai

使用教程

难度：入门约 10 分钟部署方式：库/依赖 4 步

环境要求

Node.js 18 及以上
npm / pnpm 等包管理器

安装与启动步骤

1安装依赖

在项目中安装 aimock 包。
```
npm install @copilotkit/aimock
```

2创建并启动 Mock

用 LLMock 在本地起一个端口，预设对话响应。

import { LLMock } from "@copilotkit/aimock";
const mock = new LLMock({ port: 0 });
mock.onMessage("hello", { content: "Hi there!" });
await mock.start();

3把 SDK 指向本地 Mock

在构造 OpenAI 等客户端之前设置环境变量，使其请求打到本地 mock 而非真实 API。
```
process.env.OPENAI_BASE_URL = `${mock.url}/v1`;
process.env.OPENAI_API_KEY = "sk-anything";
```
4运行测试

运行你的测试，断言返回由 mock 决定的内容。