MCP Test Client

🚀 MCP 測試客戶端

MCP 測試客戶端是一款 MCP 中間件，作為連接 Claude 和待測服務器的測試工具，主要用於在開發期間對 MCP 服務器進行全面測試，有效提升開發效率。

🚀 快速開始

MCP 測試客戶端具有獨特的雙重角色架構，既作為已註冊到 Claude 的服務器公開測試工具，又作為客戶端連接並測試其他 MCP 服務器。這種架構使得無需直接在 Claude 上註冊，就能便捷地測試 MCP 服務器。

┌─────────────┐          ┌───────────────────┐          ┌────────────────┐
│             │  工具    │                   │  客戶端    │                │
│   Claude    │─────────>│  MCP 測試客戶端  │─────────>│  待測服務器     │
│             │          │                   │          │                │
└─────────────┘          └───────────────────┘          └────────────────┘

✨ 主要特性

• 可在測試環境中輕鬆部署 MCP 服務器。
• 支持調用帶有自定義參數的單個工具。
• 能夠運行自動化測試套件，提高測試效率。
• 方便查看服務器日誌，便於問題排查。
• 可在正式註冊到 Claude 之前對服務器進行充分測試。

🔧 技術細節

MCP 測試客戶端運用了以下關鍵技術實現其功能：

• 進程管理：能夠 spawn 並管理 MCP 服務器進程。
• 官方 MCP SDK 客戶端：藉助官方的 MCP SDK 與服務器進行通信。
• 自定義傳輸：實現了用於標準輸入輸出通信的自定義傳輸。
• 測試執行：可運行測試並驗證響應結果。
• CLI 接口：提供交互式測試界面，方便用戶操作。

當前的實現處於設計計劃的第一階段，後續還有第二和第三階段的增強計劃。

📦 安裝指南

# 安裝依賴
npm install

# 構建 TypeScript 項目
npm run build

💻 使用示例

基礎用法

作為 MCP 服務器

MCP 測試客戶端通過 claude-mcp-local 腳本註冊到 Claude。以下是一些常用工具的使用示例：

// 部署一個服務器
mcp__mcp-test__mcp_test_deploy_server({
  name: "my-server",
  source_path: "/path/to/server",
  env_vars: {
    "API_KEY": "${API_KEY}"
  }
})

// 調用部署的服務器上的工具
mcp__mcp-test__mcp_test_call_tool({
  server_name: "my-server",
  tool_name: "tool_name",
  arguments: {
    // 工具特定參數
  }
})

// 對服務器運行測試
mcp__mcp-test__mcp_test_run_tests({
  server_name: "my-server"
})

// 查看服務器日誌
mcp__mcp-test__mcp_test_get_logs({
  server_name: "my-server",
  lines: 100
})

// 列出已部署的服務器
mcp__mcp-test__mcp_test_list_servers({})

// 停止一個服務器
mcp__mcp-test__mcp_test_stop_server({
  server_name: "my-server"
})

作為 CLI 工具

運行 CLI 界面進行測試：

# 使用 npm 腳本
npm run test

# 或直接運行
node dist/test-runner.js

這將提供一個交互式菜單，用於部署、測試和管理 MCP 服務器。

高級用法

MCP 測試客戶端支持以下開發流程，幫助你更高效地開發和測試 MCP 服務器：

1. 在遊樂場目錄中開發一個 MCP 服務器。
2. 使用 MCP 測試客戶端將其部署到測試環境。
3. 測試功能，調用單個工具並進行調試。
4. 修復問題並迭代直到服務器正常工作。
5. 將服務器遷移到 mcp - servers/ 目錄下。
6. 通過 claude - mcp - local 註冊到 Claude。

📚 詳細文檔

計劃中的增強包括：

• 第二階段：基於 Docker 的容器管理，全面的測試套件。
• 第三階段：遷移工具，更高級別的測試驗證。

有關完整的設計文檔，請參見 notes/mcp_test_client_design.md。