快速开始指南

安装

Docker（推荐）
本地开发
npm 包

使用 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

用于开发或自定义：

# 克隆仓库
git clone https://github.com/samanhappy/mcphub.git
cd mcphub

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

这会同时启动后端（端口 3000）和前端（端口 5173）的开发模式，Vite 开发服务器会把 API 与 MCP 请求代理到后端。本地开发默认使用 admin / admin123，可写配置保存在 data/mcp_settings.dev.json。

将 MCPHub 安装为全局包：

# 全局安装
npm install -g @samanhappy/mcphub

# 运行 MCPHub
mcphub

初始设置

1. 访问控制面板

打开浏览器并导航到：

http://localhost:3000

2. 登录

默认用户名为 admin。使用 pnpm dev 本地开发时，默认密码是 admin123。Docker、npm 包和生产启动不包含默认用户；首次启动时如果未设置 ADMIN_PASSWORD 环境变量，系统将自动生成随机密码并输出到服务器日志中。可以通过环境变量预先设置管理员密码：

# 通过环境变量设置管理员密码
ADMIN_PASSWORD=your-secure-password docker run -p 3000:3000 samanhappy/mcphub

首次登录后请及时修改管理员密码以确保安全。

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

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

fetch 服务器的示例配置：

{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"],
  "env": {}
}

基本使用

连接 AI 客户端

一旦配置了服务器，使用 MCPHub 端点连接您的 AI 客户端：

所有服务器
特定组
单个服务器
智能路由

访问所有已配置的 MCP 服务器：http://localhost:3000/mcp

访问特定组中的服务器：http://localhost:3000/mcp/{groupName}

访问单个服务器：http://localhost:3000/mcp/{serverName}

使用 AI 驱动的工具发现：http://localhost:3000/mcp/$smart

智能路由需要使用 pgvector 的 PostgreSQL 和 OpenAI API 密钥。

示例：添加热门 MCP 服务器

以下是一些您可以添加的热门 MCP 服务器：

Web Fetch 服务器

{
  "name": "fetch",
  "command": "uvx",
  "args": ["mcp-server-fetch"]
}

Playwright 浏览器自动化

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

高德地图（需要 API 密钥）

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

Slack 集成

{
  "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 日志以获取详细错误信息

无法从 AI 客户端连接

确保 MCPHub 在正确的端口上运行
检查防火墙设置
验证端点 URL 格式

需要更多帮助？加入我们的 Discord 社区获取支持！

开始使用

核心功能

配置指南

安装

初始设置

1. 访问控制面板

2. 登录

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

基本使用

连接 AI 客户端

示例：添加热门 MCP 服务器

后续步骤

服务器管理

组管理

智能路由

API 参考

故障排除

​安装

​初始设置

​1. 访问控制面板

​2. 登录

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

​基本使用

​连接 AI 客户端

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

​后续步骤

服务器管理

组管理

智能路由

API 参考

​故障排除

安装

初始设置

1. 访问控制面板

2. 登录

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

基本使用

连接 AI 客户端

示例：添加热门 MCP 服务器

后续步骤

故障排除