Mcpclientmock

🚀 mockserver - mcp

這是一個用於與 James Bloom的MockServer 進行交互的MCP（模型上下文協議）服務器。藉助它，AI助手可以以編程方式創建模擬HTTP期望、驗證請求、清除狀態以及管理MockServer實例。

🚀 快速開始

在使用 mockserver - mcp 之前，你需要先運行一個MockServer實例。可以使用以下命令通過Docker啟動：

# 使用Docker（最簡單的方式）
docker run -d -p 1080:1080 mockserver/mockserver

📦 安裝指南

使用npx（推薦）

npx mockserver-mcp

全局安裝

npm install -g mockserver-mcp
mockserver-mcp

✨ 主要特性

• 創建模擬期望：可以在MockServer上創建模擬HTTP期望。
• 驗證請求：驗證MockServer是否接收到符合特定條件的請求。
• 清除狀態：清除MockServer中的期望和記錄的請求。
• 重置服務器：對MockServer進行完全重置，清除所有期望和記錄的請求。
• 檢索請求：從MockServer檢索記錄的請求。
• 獲取狀態：獲取MockServer的連接狀態和配置信息。

📚 詳細文檔

配置

環境變量

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註冊表: https://registry.modelcontextprotocol.io

📄 許可證

本項目採用MIT許可證。