个性化部署

前置要求

DigitalOcean 账户
指向您的 VPS 的域名
Linux 命令行的基础知识

系统要求

MetaMCP 需要至少 2GB-4GB 内存以获得最佳性能。实例越大，性能越好，这是由于 MCP 服务器预分配和 Docker 操作。 推荐的 DigitalOcean Droplet：

基础/常规：2GB RAM，1 vCPU，50GB SSD（$12/月）
更好性能：4GB RAM，2 vCPU，80GB SSD（$24/月）

步骤 1：创建和配置您的 VPS

1.1 创建 Droplet

登录您的 DigitalOcean 账户
点击”创建” → “Droplets”
选择 Ubuntu 22.04 LTS 作为操作系统
选择至少 2GB RAM 的计划
选择靠近用户的数据中心区域
添加您的 SSH 密钥以安全访问
创建 droplet

1.2 初始服务器设置

通过 SSH 连接到您的服务器：

ssh root@your_server_ip

更新系统：

apt update && apt upgrade -y

安装基本包：

apt install -y curl wget git ufw nginx certbot python3-certbot-nginx

配置防火墙：

ufw allow OpenSSH
ufw allow 'Nginx Full'
ufw enable

创建非 root 用户（可选但推荐）：

adduser metamcp
usermod -aG sudo metamcp
# 切换到新用户
su - metamcp

步骤 2：安装 Docker 和 Docker Compose

2.1 安装 Docker

首先，更新您的包索引并安装先决条件：

sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

添加 Docker 的官方 GPG 密钥和仓库：

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

安装 Docker CE：

sudo apt update
sudo apt install -y docker-ce

验证 Docker 正在运行：

sudo systemctl status docker

2.2 安装 Docker Compose

下载并安装 Docker Compose：

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

2.3 配置 Docker 用户（可选）

要在不使用 sudo 的情况下运行 Docker 命令：

sudo usermod -aG docker $USER

注销并重新登录以使组更改生效，或运行：

newgrp docker

步骤 3：部署 MetaMCP

3.1 克隆仓库

cd /opt
sudo git clone https://github.com/metatool-ai/metamcp.git
sudo chown -R $USER:$USER metamcp
cd metamcp

3.2 配置环境

cp example.env .env

使用您的域名和设置编辑 .env 文件：

nano .env

⚠️ 重要安全说明：因为这是生产环境，请确保您修改 POSTGRES_PASSWORD 和 BETTER_AUTH_SECRET 的默认值。同时确保使用 HTTPS。生成安全密钥的典型方法是：

openssl rand -hex 32 | base64

要更新的关键配置：

# 您的域名 URL（生产环境必须使用 HTTPS）
APP_URL=https://yourdomain.com

# 数据库 - 从默认值更改密码！
DATABASE_URL=postgresql://postgres:YOUR_SECURE_PASSWORD@db:5432/metamcp
POSTGRES_PASSWORD=YOUR_SECURE_PASSWORD

# 生成安全密钥 - 不要使用示例值！
BETTER_AUTH_SECRET=your-super-secret-key-here
ENCRYPTION_KEY=your-32-character-encryption-key

# 可选：如果需要配置 OIDC
# OIDC_CLIENT_ID=your-oidc-client-id
# OIDC_CLIENT_SECRET=your-oidc-client-secret
# OIDC_DISCOVERY_URL=https://your-provider.com/.well-known/openid-configuration

3.3 更新生产环境的 Docker Compose

编辑 docker-compose.yml 以确保正确的卷命名：

nano docker-compose.yml

更新卷部分以避免冲突：

volumes:
  metamcp_postgres_data:
    driver: local

3.4 启动 MetaMCP

# 拉取镜像并启动服务
docker-compose up -d

# 检查服务是否正在运行
docker-compose ps

# 如果需要查看日志
docker-compose logs -f

步骤 4：配置 Nginx 反向代理

4.1 创建 Nginx 配置

创建新的站点配置：

sudo nano /etc/nginx/sites-available/metamcp

添加以下配置（将 yourdomain.com 替换为您的实际域名）：

server {
    listen 80;
    server_name yourdomain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name yourdomain.com;

    # SSL 配置（将由 Certbot 管理）
    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    # 安全标头
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;
    add_header Referrer-Policy "no-referrer-when-downgrade" always;

    location / {
        proxy_pass http://localhost:12008;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # MCP 连接的 SSE 特定优化
        proxy_buffering off;
        proxy_cache off;
        proxy_read_timeout 86400s;  # 长寿命 SSE 连接 24 小时
        proxy_send_timeout 86400s;
        
        # 用于 SSE 的 HTTP/1.1 和适当的连接处理
        proxy_set_header Connection '';
        proxy_http_version 1.1;
        
        # 更好的 SSE 支持的附加标头
        proxy_set_header Cache-Control 'no-cache';
        proxy_set_header X-Accel-Buffering 'no';
    }

    # 可选：增加客户端最大正文大小以进行文件上传
    client_max_body_size 100M;
}

4.2 启用站点

# 启用站点
sudo ln -s /etc/nginx/sites-available/metamcp /etc/nginx/sites-enabled/

# 移除默认站点
sudo rm /etc/nginx/sites-enabled/default

# 测试 nginx 配置
sudo nginx -t

# 启动 nginx
sudo systemctl enable nginx
sudo systemctl start nginx

步骤 5：使用 Let’s Encrypt 的 SSL 证书

5.1 获取 SSL 证书

首先，临时使用仅 HTTP 配置进行初始证书：

# 创建临时仅 HTTP 配置
sudo nano /etc/nginx/sites-available/metamcp-temp

添加此临时配置：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:12008;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

启用临时配置：

sudo ln -sf /etc/nginx/sites-available/metamcp-temp /etc/nginx/sites-enabled/metamcp
sudo nginx -t && sudo systemctl reload nginx

获取证书：

sudo certbot --nginx -d yourdomain.com

5.2 恢复完整配置

获取证书后，恢复完整配置：

sudo ln -sf /etc/nginx/sites-available/metamcp /etc/nginx/sites-enabled/metamcp
sudo nginx -t && sudo systemctl reload nginx

5.3 设置自动续期

# 测试自动续期
sudo certbot renew --dry-run

# 添加到 crontab 以自动续期
sudo crontab -e

添加此行以每天检查两次续期：

0 12 * * * /usr/bin/certbot renew --quiet

快速开始

核心概念

部署

集成

开发

故障排除

前置要求

系统要求

步骤 1：创建和配置您的 VPS

1.1 创建 Droplet

1.2 初始服务器设置

步骤 2：安装 Docker 和 Docker Compose

2.1 安装 Docker

2.2 安装 Docker Compose

2.3 配置 Docker 用户（可选）

步骤 3：部署 MetaMCP

3.1 克隆仓库

3.2 配置环境

3.3 更新生产环境的 Docker Compose

3.4 启动 MetaMCP

步骤 4：配置 Nginx 反向代理

4.1 创建 Nginx 配置

4.2 启用站点

步骤 5：使用 Let’s Encrypt 的 SSL 证书

5.1 获取 SSL 证书

5.2 恢复完整配置

5.3 设置自动续期

​前置要求

​系统要求

​步骤 1：创建和配置您的 VPS

​1.1 创建 Droplet

​1.2 初始服务器设置

​步骤 2：安装 Docker 和 Docker Compose

​2.1 安装 Docker

​2.2 安装 Docker Compose

​2.3 配置 Docker 用户（可选）

​步骤 3：部署 MetaMCP

​3.1 克隆仓库

​3.2 配置环境

​3.3 更新生产环境的 Docker Compose

​3.4 启动 MetaMCP

​步骤 4：配置 Nginx 反向代理

​4.1 创建 Nginx 配置

​4.2 启用站点

​步骤 5：使用 Let’s Encrypt 的 SSL 证书

​5.1 获取 SSL 证书

​5.2 恢复完整配置

​5.3 设置自动续期

前置要求

系统要求

步骤 1：创建和配置您的 VPS

1.1 创建 Droplet

1.2 初始服务器设置

步骤 2：安装 Docker 和 Docker Compose

2.1 安装 Docker

2.2 安装 Docker Compose

2.3 配置 Docker 用户（可选）

步骤 3：部署 MetaMCP

3.1 克隆仓库

3.2 配置环境

3.3 更新生产环境的 Docker Compose

3.4 启动 MetaMCP

步骤 4：配置 Nginx 反向代理

4.1 创建 Nginx 配置

4.2 启用站点

步骤 5：使用 Let’s Encrypt 的 SSL 证书

5.1 获取 SSL 证书

5.2 恢复完整配置

5.3 设置自动续期