先决条件

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

安装方法

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 (或兼容的嵌入服务)

数据库设置

# 运行带 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

故障排除

下一步