 ](https://www.npmjs.com/package/mockoon-mcp) ](https://www.npmjs.com/package/mockoon-mcp)
mockoon mcp
允许AI助手(Claude、GitHub Copilot、Cursor等)创建和管理的MCP服务器 嘲讽 通过自然语言模拟API。
______________________________________________________________________
需求
- 18+
- 模拟桌面 --用于通过UI管理环境文件
- Mockoon命令行界面 *(可选)* --仅当您想使用时才需要
start_server/stop_server以编程方式启动模拟服务器的工具(npm install -g @mockoon/cli)
______________________________________________________________________
配置
无需安装。使用配置您的AI客户端 npx:
VS代码/GitHub副本
创建 .vscode/mcp.json 在您的工作空间中:
{
"servers": {
"mockoon": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mockoon-mcp@latest"]
}
}
}克劳德桌面版
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mockoon": {
"command": "npx",
"args": ["-y", "mockoon-mcp@latest"]
}
}
}光标
编辑 ~/.cursor/mcp.json (全球)或 .cursor/mcp.json 在您的项目中:
{
"mcpServers": {
"mockoon": {
"command": "npx",
"args": ["-y", "mockoon-mcp@latest"]
}
}
}环境变量
| 变量 | 描述 |
|---|---|
MOCKOON_STORAGE_DIR | 覆盖主存储目录(默认:Mockoon Desktop的存储文件夹) |
MOCKOON_DATA_DIRS | 以分号分隔的用于搜索环境文件的附加目录列表 |
默认存储路径:
- 视窗:
%APPDATA%\mockoon\storage - macOS/Linux:
~/.config/mockoon/storage
例子:
"env": {
"MOCKOON_DATA_DIRS": "/path/to/dir1;/path/to/dir2"
}______________________________________________________________________
可用工具
环境
| 工具 | 说明 |
|---|---|
list_environments | 列出所有具有文件路径和端口的环境 |
create_environment | 创建新环境 |
delete_environment | 永久删除环境文件 |
路线
| 工具 | 说明 |
|---|---|
list_routes | 列出环境中的所有路由(UUID、方法、端点、响应计数) |
get_route | 检查包含所有响应、规则、标头和正文的单个路由 |
create_route | 使用单个默认响应创建路由 |
create_route_with_responses | 在一次调用中创建路由+N个响应(默认+条件) |
bulk_create_routes | 在一个调用中创建N个路由-非常适合构建整个API |
update_route | 更新方法、端点、文档和/或默认响应字段 |
duplicate_route | 使用新的UUID克隆路由(包括所有响应) |
delete_route | 删除路线及其所有响应 |
add_route_response | 向现有路由添加条件/备选响应 |
set_default_response | 更改标记为默认的响应 |
get_default_response | 返回当前默认响应(快速检查) |
数据桶(模板)
| 工具 | 说明 |
|---|---|
list_templates | 列出环境中的所有数据库 |
create_template | 创建新的数据库 |
update_template | 更新数据库的内容 |
delete_template | 删除数据包 |
服务器
| 工具 | 说明 |
|---|---|
start_server | 为环境启动模拟服务器 |
stop_server | 停止正在运行的模拟服务器 |
list_running_servers | 列出当前运行的所有模拟服务器 |
注:start_server和stop_server需要 Mockoon命令行界面 全球安装(npm install -g @mockoon/cli).如果只使用Mockoon Desktop,这些工具将无法工作,但所有其他工具(环境、路由、数据库)都可以在没有CLI的情况下工作。
______________________________________________________________________
示例提示
以下是一些示例短语,您可以对您的AI助手说,以便通过此MCP服务器与Mockoon进行交互:
探索环境和路线
- *“列出所有可用的Mockoon环境。”*
- *“给我看看Taccuino环境中的所有路线。”*
- *“获取路线的全部细节
GET /users/:id,包括所有响应和规则。"*
创建管线
- *“创建一个
GET /productsDemo API环境中的路由,返回状态为200的3个产品的JSON数组。”* - *“添加一个
POST /auth/login路由有两个响应:200个带有令牌体,401个未经授权。"* - *“为
Task资源下/tasks在演示环境中。"*
更新和管理路线
- *“更改默认响应
GET /users以空体返回状态204。"* - *“复制
GET /orders路线。"* - *“删除
DELETE /legacy/endpoint从环境出发的路线。"* - *“添加条件403响应
POST /documents当X-Roleheader等于guest."*
数据桶
- *“创建一个名为
UserList在演示API中使用5个伪造用户的JSON数组。"* - *“更新
ProductCatalog带有新项目列表的数据库。"*
服务器管理
- *“启动Taccuino环境的模拟服务器。”*
- *“停止所有正在运行的模拟服务器。”*
- *“当前正在运行哪些Mockoon环境?”*
______________________________________________________________________
运作原理
服务器通过以下方式进行通信 标准 (JSON-RPC 2.0)。它直接读写Mockoon的环境JSON文件,不涉及REST API。
如果满足以下条件,MCP服务器所做的更改会自动反映在模拟桌面中 环境文件监视器 已启用。首选 应用→ 设置 并将其设置为 自动 用于静音重新加载。
______________________________________________________________________
许可证
麻省理工学院——见 许可证.
