各种平台的详细安装说明
# 拉取最新镜像 docker pull samanhappy/mcphub:latest # 使用默认设置运行 docker run -d \ --name mcphub \ -p 3000:3000 \ samanhappy/mcphub:latest
# 创建您的配置文件 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
docker run -d \ --name mcphub \ -p 3000:3000 \ -e PORT=3000 \ -e BASE_PATH="" \ samanhappy/mcphub:latest
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
# 运行带 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
http://localhost:3000
Docker 问题
# 检查是什么在使用端口 3000 lsof -i :3000 # 使用不同的端口 docker run -p 8080:3000 samanhappy/mcphub
# 检查容器日志 docker logs mcphub # 交互式运行以进行调试 docker run -it --rm samanhappy/mcphub /bin/bash
npm 安装问题
# 使用 npx 而不是全局安装 npx @samanhappy/mcphub # 或修复 npm 权限 npm config set prefix ~/.npm-global export PATH=~/.npm-global/bin:$PATH
# 检查 Node 版本 node --version # 使用 nvm 安装 Node 18+ nvm install 18 nvm use 18
网络问题
ps aux | grep mcphub
netstat -tlnp | grep 3000
127.0.0.1:3000
localhost:3000
智能路由问题
# 测试数据库连接 psql $DATABASE_URL -c "SELECT 1;" # 检查是否安装了 pgvector psql $DATABASE_URL -c "CREATE EXTENSION IF NOT EXISTS vector;"