MCP Server Hub Server

🚀 MCP 服務器指南

本指南將詳細介紹 MCP 服務器的安裝、配置、使用、故障排除以及開發測試等方面的內容，幫助你快速上手並高效使用 MCP 服務器。

🚀 快速開始

📦 安裝指南

下載代碼

從 GitHub 上克隆倉庫：

git clone https://github.com/your-repository/mcp-server.git
cd mcp-server

安裝依賴

使用 npm 安裝項目依賴：

npm install

啟動服務器

運行主程序文件：

node src/index.js

✨ 主要特性

本 MCP 服務器具備以下特性：

• 可通過配置文件靈活配置服務器參數。
• 支持與 LLM 客戶端（如 Cline）進行交互。
• 提供工具列表和調用功能，方便開發和使用。
• 具備完善的日誌查看和故障排除機制。

📚 詳細文檔

配置 MCP 服務器

編輯配置文件 mcp_hub_config.json，確保路徑正確。例如：

{
  "wsPort": 8081,
  "configPath": "path/to/mcp_server_settings.json"
}

使用 LLM 客戶端（如 Cline）

在 LLM 客戶端中配置 MCP 服務器： 編輯客戶端的 MCP 配置文件，例如 cline_mcp_settings.json：

{
  "mcpServers": {
    "gateway-client": {
      "command": "node",
      "args": ["path/to/mcp-server/gateway-client.js"],
      "options": {
        "cwd": "path/to/mcp-server"
      }
    }
  }
}

工具使用指南

💻 使用示例 - 列出工具

在 LLM 客戶端中執行以下命令：

llm list-tools

輸出示例：

{
  "tools": ["hub__example", "thought-server__integrated-thinking"]
}

💻 使用示例 - 調用工具

使用工具的全限定名（例如 hub__example）進行調用：

llm call-tool --tool hub__example --args '{"input": "test"}'

故障排除

問題排查

1. 啟動失敗：檢查配置文件路徑和命令是否正確。
2. 連接問題：確保服務器正在運行，網絡防火牆沒有阻止 WebSocket 端口（默認 ws://localhost:8081）。

日誌查看

查看 MCP 服務器日誌：

# 在終端中運行以下命令查看即時輸出
npm run dev

開發與測試

開發模式

使用 nodemon 監聽文件變化：

npm run dev

測試

執行單元測試：

npm test

更多詳細內容請參考項目文檔。