Skip to main content

​
安装

使用 Docker 是最快的开始方式：
# 使用默认配置运行
docker run -p 3000:3000 samanhappy/mcphub
或者挂载自定义配置：
# 使用自定义 MCP 设置运行
docker run -p 3000:3000 \
  -v $(pwd)/mcp_settings.json:/app/mcp_settings.json \
  samanhappy/mcphub

​
初始设置

​
1. 访问控制面板

打开浏览器并导航到： 
http://localhost:3000

​
2. 登录

默认用户名为 admin。首次启动时，如果未设置 ADMIN_PASSWORD 环境变量，系统将自动生成随机密码并输出到服务器日志中。 可以通过环境变量预先设置管理员密码： 
# 通过环境变量设置管理员密码
ADMIN_PASSWORD=your-secure-password docker run -p 3000:3000 samanhappy/mcphub
首次登录后请及时修改管理员密码以确保安全。

​
3. 配置您的第一个 MCP 服务器

  1. 在控制面板中点击 “添加服务器”
  2. 输入服务器详细信息：
    • 名称: 唯一标识符（例如 fetch）
    • 命令: 可执行命令（uvx）
    • 参数: 命令参数（["mcp-server-fetch"]）
    • 环境: 任何所需的环境变量
fetch 服务器的示例配置： 
{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"],
  "env": {}
}

​
基本使用

​
连接 AI 客户端

一旦配置了服务器，使用 MCPHub 端点连接您的 AI 客户端：
访问所有已配置的 MCP 服务器：http://localhost:3000/mcp

​
示例：添加热门 MCP 服务器

以下是一些您可以添加的热门 MCP 服务器： 
{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"]
}

{
  "name": "playwright",
  "command": "npx",
  "args": ["@playwright/mcp@latest", "--headless"]
}

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

{
  "name": "slack",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-slack"],
  "env": {
    "SLACK_BOT_TOKEN": "your-bot-token",
    "SLACK_TEAM_ID": "your-team-id"
  }
}

​
后续步骤

服务器管理

学习高级服务器配置和管理

组管理

将服务器组织成逻辑组

智能路由

设置 AI 驱动的工具发现

API 参考

探索完整的 API 文档

​
故障排除

  • 检查 MCP 服务器命令是否在您的 PATH 中可访问
  • 验证环境变量是否正确设置
  • 检查 MCPHub 日志以获取详细错误信息
  • 确保 MCPHub 在正确的端口上运行
  • 检查防火墙设置
  • 验证端点 URL 格式
需要更多帮助？加入我们的 Discord 社区 获取支持！