Skip to main content

​
先决条件

在安装 MCPHub 之前，请确保您具备以下先决条件：
  • Node.js 18+ (用于本地开发)
  • Docker (推荐用于生产环境)
  • pnpm (用于本地开发)
智能路由的可选要求：
  • PostgreSQL 带 pgvector 扩展
  • OpenAI API Key 或兼容的嵌入服务

​
安装方法

  • Docker (推荐)
  • npm 包
  • 本地开发
  • Kubernetes

​
Docker 安装

Docker 是在生产环境中部署 MCPHub 的推荐方式。

​
1. 基础安装

# 拉取最新镜像
docker pull samanhappy/mcphub:latest

# 使用默认设置运行
docker run -d \
  --name mcphub \
  -p 3000:3000 \
  samanhappy/mcphub:latest

​
2. 使用自定义配置

# 创建您的配置文件
cat > mcp_settings.json << 'EOF'
{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    }
  }
}
EOF

# 使用挂载的配置运行
docker run -d \
  --name mcphub \
  -p 3000:3000 \
  -v $(pwd)/mcp_settings.json:/app/mcp_settings.json \
  samanhappy/mcphub:latest

​
3. 使用环境变量

docker run -d \
  --name mcphub \
  -p 3000:3000 \
  -e PORT=3000 \
  -e BASE_PATH="" \
  samanhappy/mcphub:latest

​
4. Docker Compose

创建 docker-compose.yml 文件：
version: '3.8'
services:
  mcphub:
    image: samanhappy/mcphub:latest
    ports:
      - "3000:3000"
    volumes:
      - ./mcp_settings.json:/app/mcp_settings.json
    environment:
      - PORT=3000
      - BASE_PATH=""
      - REQUEST_TIMEOUT=60000
    restart: unless-stopped

  # 可选：用于智能路由的 PostgreSQL
  postgres:
    image: pgvector/pgvector:pg16
    environment:
      POSTGRES_DB: mcphub
      POSTGRES_USER: mcphub
      POSTGRES_PASSWORD: mcphub_password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  postgres_data:
运行命令：
docker-compose up -d

​
智能路由设置 (可选)

智能路由使用向量语义搜索提供 AI 驱动的工具发现。

​
先决条件

  1. PostgreSQL 带 pgvector 扩展
  2. OpenAI API Key (或兼容的嵌入服务)

​
数据库设置

  • Docker PostgreSQL
  • 现有 PostgreSQL
  • 云 PostgreSQL
# 运行带 pgvector 的 PostgreSQL
docker run -d \
  --name mcphub-postgres \
  -e POSTGRES_DB=mcphub \
  -e POSTGRES_USER=mcphub \
  -e POSTGRES_PASSWORD=your_password \
  -p 5432:5432 \
  pgvector/pgvector:pg16

​
验证

安装后，验证 MCPHub 是否正常工作：

​
控制台访问

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

​
故障排除

端口已被使用：
# 检查是什么在使用端口 3000
lsof -i :3000

# 使用不同的端口
docker run -p 8080:3000 samanhappy/mcphub
容器无法启动：
# 检查容器日志
docker logs mcphub

# 交互式运行以进行调试
docker run -it --rm samanhappy/mcphub /bin/bash
权限错误：
# 使用 npx 而不是全局安装
npx @samanhappy/mcphub

# 或修复 npm 权限
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
Node 版本问题：
# 检查 Node 版本
node --version

# 使用 nvm 安装 Node 18+
nvm install 18
nvm use 18
无法访问控制台：
  • 检查 MCPHub 是否在运行：ps aux | grep mcphub
  • 验证端口绑定：netstat -tlnp | grep 3000
  • 检查防火墙设置
  • 尝试通过 127.0.0.1:3000 而不是 localhost:3000 访问
AI 客户端无法连接：
  • 确保端点 URL 正确
  • 检查 MCPHub 是否在代理后面
  • 验证 Kubernetes/Docker 环境中的网络策略
数据库连接失败：
# 测试数据库连接
psql $DATABASE_URL -c "SELECT 1;"

# 检查是否安装了 pgvector
psql $DATABASE_URL -c "CREATE EXTENSION IF NOT EXISTS vector;"
嵌入服务错误：
  • 验证 OpenAI API 密钥是否有效
  • 检查互联网连接
  • 监控速率限制

​
下一步

配置

配置您的 MCP 服务器和设置

快速开始

5分钟内启动并运行

服务器管理

了解如何管理您的 MCP 服务器

API 参考

探索完整的 API 文档
⌘I