MCP Server Tester Po4

MCP服務器測試工具是一個配置驅動的測試解決方案，用於驗證、基準測試和確保與AI模型集成的MCP服務器的可靠性。它支持自動發現工具、生成智能測試用例、執行驗證並生成詳細報告。

開發者工具人工智能聊天機器人 #AI測試 #協議驗證 #自動化測試 #配置驅動 .TypeScript

rating : 2.5 points

downloads : 11

update time : 2025-04-23

Installation

Copy the following command to your Client for configuration

{
  "numTestsPerTool": 3,
  "timeoutMs": 10000,
  "outputFormat": "console",
  "outputPath": "./reports/results.json",
  "verbose": false,
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./"],
      "env": {
        "DEBUG": "true"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token-here"
      }
    },
    "dev-server": {
      "command": "node",
      "args": ["/absolute/path/to/your/dev-server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

{
  "servers": ["filesystem", "dev-server"],
  "numTestsPerTool": 3,
  // other settings...
  "mcpServers": {
    // server definitions...
  }
}

{
  "mcpServers": {
    "my-dev-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

Note: Your key is sensitive information, do not share it with anyone.

🚀 MCP 服務器測試器文檔

MCP 服務器測試器是一款專門用於測試支持 MCP 協議服務器的工具。它可以連接到 MCP 服務器，發現可用工具，並執行自動化測試，以此來驗證服務器的行為是否符合預期。

🚀 快速開始

基本設置

創建默認配置文件：
```
mcp-server-tester --init
```
編輯 mcp-servers.json 文件：添加您自己的服務器和配置。
創建 .env 文件：包含您的 Anthropic API 密鑰。
```
echo "ANTHROPIC_API_KEY=your-api-key-here" > .env
```
運行測試：
```
mcp-server-tester
```

測試開發版本

在 mcp-servers.json 中添加開發服務器配置：

{
  "mcpServers": {
    "my-dev-server": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "DEBUG": "true",
        "NODE_ENV": "development"
      }
    }
  }
}

然後運行測試：

mcp-server-tester

多配置文件測試

創建不同的配置文件以應對不同環境：

cp mcp-servers.json config-dev.json
cp mcp-servers.json config-prod.json

編輯每個文件並設置相應的配置，然後運行：

mcp-server-tester ./config-dev.json
mcp-server-tester ./config-prod.json

✨ 主要特性

能夠連接到 MCP 服務器，發現可用工具。
執行自動化測試，驗證服務器行為。
支持多配置文件測試，適應不同環境。
提供多種報告格式，方便查看和分析測試結果。

📦 安裝指南

# 安裝依賴
npm install

💻 使用示例

基礎用法

# 運行測試器
node src/server.js

高級用法

# 使用不同配置運行
node src/server.js --config config-dev.json

📚 詳細文檔

配置選項

服務器配置

在 mcp-servers.json 中定義服務器：

{
  "mcpServers": {
    "server1": {
      "command": "node",
      "args": ["index.js"],
      "env": {}
    }
  }
}

測試設置

配置文件中的測試選項包括：

屬性	詳情
`numWorkers`	並行執行的工人數（默認：4）
`timeoutMs`	每個工具執行的最大時間（毫秒，默認：1000）
`outputFormat`	報告格式（支持：`console`、`json`、`html`，默認：`console`）
`outputPath`	輸出文件路徑（默認：`./test-results.json` 或 `stdout`）

測試流程

連接與發現

連接到服務器：測試器使用 TCP 協議連接到 MCP 服務器。
發現工具：通過 RPC 請求獲取服務器支持的工具列表。

執行與驗證

對於每個工具，測試器：

發起 RPC 請求。
等待響應。
驗證結果是否符合預期。

報告格式

控制檯輸出（默認）

直接在終端顯示測試結果。

JSON 報告

生成結構化的 JSON 文件，路徑由 outputPath 指定。

HTML 報告

生成包含可視化界面的 HTML 文件，便於分析和查看。

故障排除

連接問題

確認服務器配置無誤。
驗證服務器是否支持 MCP 協議。
增加 timeoutMs 以應對慢服務器。
啟用詳細日誌記錄：設置 verbose: true。

API 密鑰問題

確保 API 密鑰有效且正確無誤。
檢查 .env 文件是否位於項目根目錄。
驗證密鑰是否有空格或多餘字符。

工具執行失敗

確認服務器實現 MCP 協議正確。
查看服務器日誌獲取錯誤信息。
核實工具參數配置無誤。

項目結構

mcp-server-tester/
├── package.json          # 項目依賴和腳本
├── src/                 # 源代碼目錄
│   ├── server.js        # 測試器主程序
│   └── worker.js        # 並行執行的工件
├── mcp-servers.json      # 服務器配置文件
└── .env                 # 環境變量文件

開發指南

代碼結構

src/server.js：主程序，解析命令行參數並初始化測試。
src/worker.js：處理每個工具的執行和驗證。
src/utils/：包含日誌、RPC 請求等公用函數。

貢獻指南

提交代碼前，請確保通過所有單元測試。
為新功能或修復添加相關文檔。
在 GitHub 上提交 Pull Request。

🔧 技術細節

MCP 服務器測試器通過 TCP 協議連接到 MCP 服務器，使用 RPC 請求與服務器進行通信。主程序 src/server.js 負責解析命令行參數並初始化測試，src/worker.js 處理每個工具的執行和驗證。測試過程中，測試器會根據配置文件中的選項，並行執行多個工具的測試，並根據設置的報告格式生成相應的測試報告。