MCP Node Proxy

🚀 MCP (Model Context Protocol) 客户端管理器 - 本地服务，提供Web界面管理MCP服务器连接和工具调用

📖 简介

MCP Node Proxy 是一个便捷的本地服务工具，让您可以通过Web界面轻松管理和使用各种MCP服务器。无需复杂配置，一键启动即可使用。

✨ 特性

• 🎯 一键启动: 通过 npx @yanss1201/mcp-node-proxy 直接启动
• 🌐 Web界面: 友好的浏览器界面管理MCP连接
• 🔧 多服务器支持: 支持连接各种MCP服务器
• ⚙️ 灵活配置: 支持端口、主机等参数自定义
• 📊 实时状态: 实时显示服务和连接状态
• 🛠️ 工具调用: 直接在界面中调用MCP工具
• 🔍 详细日志: 可选的详细输出模式

🚀 快速开始

安装和启动

# 直接启动（推荐）
npx @yanss1201/mcp-node-proxy

# 或者全局安装后使用
npm install -g mcp-node-proxy
mcp-node-proxy

基本使用

1. 启动服务: 执行上述命令后，服务将在本地启动
2. 访问界面: 访问 http://localhost:3001 页面
3. 配置MCP服务器: 填写MCP服务器配置信息
4. 开始使用: 获取工具列表并调用工具

🎛️ 命令行选项

npx @yanss1201/mcp-node-proxy [选项]

选项:
  -p, --port <port>     指定服务端口 (默认: 3001)
  -h, --host <host>     指定服务主机 (默认: localhost)
  -v, --verbose         详细输出模式
  --help                显示帮助信息

示例:
  npx @yanss1201/mcp-node-proxy                    # 使用默认配置
  npx @yanss1201/mcp-node-proxy --port 3002       # 指定端口
  npx @yanss1201/mcp-node-proxy --verbose         # 详细输出

🔧 配置示例

MCP服务器配置格式

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

高德地图服务器示例

{
  "mcpServers": {
    "amap-maps": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-amap-api-key"
      }
    }
  }
}

📡 API接口

健康检查

GET /health

返回服务状态信息

获取服务状态

GET /status

返回详细的服务状态和配置信息

初始化MCP客户端

POST /init-client
Content-Type: application/json

{
  "id": "1",
  "name": "服务器名称",
  "description": "服务器描述",
  "serverConfig": "{MCP服务器配置JSON字符串}"
}

获取工具列表

POST /list-tools

返回当前MCP服务器提供的工具列表

调用工具

POST /call-tool
Content-Type: application/json

{
  "toolName": "工具名称",
  "arguments": {
    "参数名": "参数值"
  }
}

🔧 故障排除

常见问题

Q: 端口被占用怎么办？ A: 使用 --port 参数指定其他端口，或者CLI会自动寻找可用端口

Q: MCP服务器连接失败？ A: 检查服务器配置是否正确，确保API密钥等环境变量设置正确

Q: 工具调用失败？ A: 使用 --verbose 模式查看详细日志，检查参数格式是否正确

调试模式

# 启用详细输出模式
npx mcp-client-manager --verbose

🛠️ 开发

本地开发

# 克隆项目
git clone <repository-url>
cd mcp-client-manager

# 安装依赖
npm install

# 开发模式启动
npm run dev

项目结构

node-service/
├── bin/cli.js              # CLI入口文件
├── mcp-client-service.js   # 主服务文件
├── package.json            # 包配置
└── README.md              # 文档

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

MIT License - 详见 LICENSE 文件

🔗 相关链接

• Model Context Protocol
• MCP SDK
• Issues

🎉 享受使用MCP客户端管理器！