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 服务器

编辑配置文件 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

更多详细内容请参考项目文档。