MCP Test

🚀 MCP服務器測試工具

MCP服務器測試工具是一個專門用於測試其他MCP服務器的工具，採用TypeScript實現，通過標準輸入輸出（STDIO）模式進行測試。它能夠幫助開發者快速、準確地驗證MCP服務器的各項功能，提高開發效率和服務器的穩定性。

🚀 快速開始

你可以根據自己的需求選擇不同的使用方式，以下為你詳細介紹安裝和使用方法。

✨ 主要特性

• 連接測試：驗證目標MCP服務器的基本連接和初始化情況。
• 能力發現：自動發現並列出目標服務器的所有工具、資源和提示信息。
• 工具調用測試：測試特定工具，確保其正常工作。
• 清晰的測試報告：以結構化、易讀的格式展示測試過程和結果。

📦 安裝指南

使用npx（推薦）

你可以直接從GitHub運行MCP測試工具，無需安裝：

npx github:Peterpan-MU/MCP-Test

本地安裝

# 克隆倉庫
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test

# 安裝依賴
npm install

# 構建項目
npm run build

💻 使用示例

方法一：作為獨立的MCP服務器

在你的MCP客戶端（如Claude Desktop）中配置此服務器：

選項A：直接從GitHub運行（推薦）

{
  "mcpServers": {
    "mcp-tester": {
      "command": "npx",
      "args": ["-y", "github:Peterpan-MU/MCP-Test"]
    }
  }
}

選項B：使用包名（本地安裝後）

# 首先，全局安裝或本地鏈接
npm install -g github:Peterpan-MU/MCP-Test
# 或者
cd MCP-Test && npm link

然後進行配置：

{
  "mcpServers": {
    "mcp-tester": {
      "command": "npx",
      "args": ["mcp-server-tester"]
    }
  }
}

選項C：本地開發

{
  "mcpServers": {
    "mcp-tester": {
      "command": "node",
      "args": ["E:\\MCP Test\\dist\\index.js"]
    }
  }
}

之後，從你的MCP客戶端調用測試工具。

方法二：直接運行測試

# 如果已本地安裝
npm test

# 或者直接使用npx運行
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test
npm install
npm test

可用工具

1. test_server_connection

測試目標MCP服務器的基本連接能力。 參數：

• command（字符串）：啟動命令，例如 "node"、"python"、"uvx"。
• args（數組）：命令參數，例如 ["server.js"]。
• env（對象，可選）：環境變量。

示例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"],
  "env": {
    "API_KEY": "your_key"
  }
}

輸出：詳細的連接測試報告，包括：

• 連接狀態
• 初始化結果
• 測試過程步驟

2. test_server_capabilities

全面測試目標MCP服務器的所有能力。 參數：

• command（字符串）：啟動命令。
• args（數組）：命令參數。
• env（對象，可選）：環境變量。

示例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"]
}

輸出：完整的能力報告，包括：

• 所有可用工具及其描述列表
• 所有可用資源列表
• 所有可用提示詞列表
• 每種能力類型的統計信息

3. test_tool_call

測試在目標MCP服務器上調用特定工具。 參數：

• command（字符串）：啟動命令。
• args（數組）：命令參數。
• env（對象，可選）：環境變量。
• test_tool（字符串）：要測試的工具名稱。
• tool_arguments（對象，可選）：傳遞給工具的參數。

示例：

{
  "command": "node",
  "args": ["/path/to/your_server.js"],
  "test_tool": "echo",
  "tool_arguments": {
    "message": "Hello, MCP!"
  }
}

輸出：工具調用測試報告，包括：

• 調用是否成功
• 返回的內容
• 是否發生錯誤

測試示例

示例1：測試一個簡單的Node.js MCP服務器

假設你有一個名為 simple_server.js 的MCP服務器：

1. 連接測試：

{
  "command": "node",
  "args": ["/servers/simple_server.js"]
}

2. 能力測試：

{
  "command": "node",
  "args": ["/servers/simple_server.js"]
}

3. 工具調用測試（假設服務器有一個 "get_time" 工具）：

{
  "command": "node",
  "args": ["/servers/simple_server.js"],
  "test_tool": "get_time",
  "tool_arguments": {}
}

示例2：測試一個Python MCP服務器

{
  "command": "python",
  "args": ["/servers/python_server.py"]
}

示例3：測試一個通過uvx安裝的MCP服務器

{
  "command": "uvx",
  "args": ["mcp-server-time"]
}

示例測試報告

連接測試報告

============================================================
🧪 MCP Server 連接測試報告
============================================================

📋 測試配置:
  命令: node
  參數: server.js

🔄 測試過程:
  🔌 正在連接到目標MCP Server...
  ✅ 連接初始化成功
  ✅ 基本連接測試通過
  🎉 所有測試步驟完成

✅ 測試結果: 成功
  狀態: connected
  消息: 目標服務器成功響應初始化請求

============================================================

能力測試報告

============================================================
🧪 MCP Server 能力測試報告
============================================================

📋 測試配置:
  命令: node
  參數: server.js

🔄 測試過程:
  🔌 正在連接到目標MCP Server...
  ✅ 連接初始化成功
  🔍 正在獲取服務器能力...
  📦 發現 3 個工具
  📚 發現 0 個資源
  💬 發現 0 個提示詞
  ✅ 能力測試完成
  🎉 所有測試步驟完成

✅ 測試結果: 成功

📦 工具列表 (3):
  1. echo
     描述: Echo back the provided message
  2. add
     描述: Add two numbers together
  3. get_time
     描述: Get current time

📚 資源列表 (0):
  (無資源或不支持)

💬 提示詞列表 (0):
  (無提示詞或不支持)

============================================================

📚 詳細文檔

配置文件

參考 test_config_example.json 瞭解如何配置多個測試服務器和測試場景。

故障排除

問題：MCP錯誤 -32000：連接關閉

此錯誤通常意味著MCP客戶端無法與服務器建立連接。 解決方案：

1. 嘗試使用選項C（本地路徑）：

{
  "mcpServers": {
    "mcp-tester": {
      "command": "node",
      "args": ["E:\\MCP Test\\dist\\index.js"]
    }
  }
}

2. 驗證npx能否找到該包：

npx -y github:Peterpan-MU/MCP-Test

然後輸入一個測試JSON-RPC請求：

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}

3. 檢查Node.js版本：

node --version  # 應 >= 18.0.0

4. 嘗試清除npx緩存：

npx clear-npx-cache
# 或者
rm -rf ~/.npm/_npx

5. 先進行本地安裝：

npm install -g github:Peterpan-MU/MCP-Test

然後在配置中使用 "args": ["mcp-server-tester"]。

問題：連接超時 (-32001)

解決方案：

• 確保安裝的是最新版本（dist/ 文件是預構建的，無需編譯）。
• 如果使用npx和GitHub URL，請檢查網絡連接。
• 嘗試使用本地安裝選項。

問題：工具調用失敗

解決方案：

• 首先使用 test_server_capabilities 查看可用工具。
• 檢查工具參數是否正確。
• 驗證目標服務器的路徑和依賴項。

問題：導入錯誤

解決方案：

cd "E:\MCP Test"
npm install
npm run build

🔧 技術細節

項目結構

MCP-Test/
├── src/
│   ├── index.ts              # 主MCP測試服務器
│   ├── tester.ts             # 測試邏輯實現
│   ├── example-server.ts     # 用於測試的示例服務器
│   └── test.ts               # 測試運行腳本
├── dist/                     # 編譯後的JavaScript（生成）
├── package.json              # NPM包配置
├── tsconfig.json             # TypeScript配置
├── requirements.txt          # Python依賴項（舊版）
├── README.md                 # 本文件
├── LICENSE                   # MIT許可證
├── .gitignore               # Git忽略規則
└── test_config_example.json # 配置示例

開發

構建項目

npm run build

監聽模式（開發）

npm run dev

運行測試

npm test

發佈到npm（可選）

要將此包發佈到npm以便更方便地訪問：

# 登錄到npm（僅首次需要）
npm login

# 發佈包
npm publish

發佈後，用戶可以運行：

npx mcp-server-tester

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE 文件。

貢獻

歡迎提出問題和提交拉取請求！

相關資源

• MCP官方文檔
• MCP TypeScript SDK
• MCP服務器列表

變更日誌

版本 1.0.0（TypeScript）

• 完全用TypeScript重寫。
• 支持npx安裝。
• 改進了類型安全性和錯誤處理。
• 更好地集成到Node.js生態系統中。

版本 0.1.0（Python - 舊版）

• 最初的Python實現。
• 基本的測試功能。
• 支持STDIO模式。