MCPClientMock

mockserver-mcp

一个用于与 James Bloom's MockServer 交互的 MCP（Model Context Protocol）服务。它使 AI 助手能够以编程方式创建模拟 HTTP 预期、验证请求、清除状态并管理 MockServer 实例。

前置条件

你需要一个正在运行的 MockServer 实例：

# Using Docker (easiest)
docker run -d -p 1080:1080 mockserver/mockserver

安装

使用 npx（推荐）

npx mockserver-mcp

全局安装

npm install -g mockserver-mcp
mockserver-mcp

配置

环境变量

变量	描述	默认值
MOCKSERVER_HOST	MockServer 主机名	localhost
MOCKSERVER_PORT	MockServer 端口	1080

MCP 客户端配置

将以下内容添加到你的 MCP 客户端配置文件中（例如 Claude Desktop、Kiro、Cursor）：

{
  "mcpServers": {
    "mockserver": {
      "command": "npx",
      "args": ["-y", "mockserver-mcp"],
      "env": {
        "MOCKSERVER_HOST": "localhost",
        "MOCKSERVER_PORT": "1080"
      }
    }
  }
}

对于团队共用的 MockServer，请将 MOCKSERVER_HOST 更改为服务器地址。

可用工具

mockserver_create_expectation

在 MockServer 上创建一个模拟 HTTP 预期。

参数：

• httpRequest（必填）：请求匹配条件
  • method：HTTP 方法（GET、POST、PUT、DELETE 等）
  • path：要匹配的 URL 路径
  • queryStringParameters：要匹配的查询参数
  • headers：要匹配的标头
  • body：请求体匹配器，包含 type（STRING、JSON、REGEX、XPATH、JSON_PATH）和 value
• httpResponse：响应配置
  • statusCode：HTTP 状态码
  • headers：响应标头
  • body：响应体（字符串或对象）
  • delay：响应延迟，包含 timeUnit 和 value
• times：匹配次数（remainingTimes、unlimited）
• timeToLive：预期的有效期（timeUnit、timeToLive）

示例：

{
  "httpRequest": {
    "method": "GET",
    "path": "/api/users"
  },
  "httpResponse": {
    "statusCode": 200,
    "body": { "users": [] }
  }
}

mockserver_verify

验证 MockServer 是否收到符合条件的请求。

参数：

• httpRequest（必填）：请求匹配条件（与 create_expectation 相同）
• times：预期请求数
  • atLeast：最少请求数
  • atMost：最多请求数
  • exactly：确切请求数

示例：

{
  "httpRequest": {
    "method": "POST",
    "path": "/api/orders"
  },
  "times": {
    "atLeast": 1
  }
}

mockserver_clear

清除 MockServer 中的预期和已记录请求。

参数：

• httpRequest（可选）：用于清除特定预期的请求匹配器。如果未提供，则清除全部内容。

示例：

{
  "httpRequest": {
    "path": "/api/users"
  }
}

mockserver_reset

完全重置 MockServer，清除所有预期和已记录请求。

参数： 无

mockserver_retrieve_requests

从 MockServer 获取已记录的请求。

参数：

• httpRequest（可选）：用于筛选已记录请求的请求匹配器

示例：

{
  "httpRequest": {
    "method": "GET"
  }
}

mockserver_status

获取 MockServer 连接状态和配置。

参数： 无

为什么使用模拟？

API 模拟支持提前测试——在后端准备就绪之前，就可以开始构建和测试前端或集成。无需再等待。更快交付。

要求

• Node.js >= 18.0.0
• 一个正在运行的 MockServer 实例

链接

• npm: https://www.npmjs.com/package/mockserver-mcp
• GitHub: https://github.com/Akkshay10/MCPClientMock
• MCP Registry: https://registry.modelcontextprotocol.io

许可证

MIT