MCP 部署指南：选择最适合你的部署方式

选择合适的部署方式，是使用 MCP 的第一步。AskTable MCP Server 提供了四种部署模式，适应不同的使用场景。

本文将帮助你理解各种部署模式的特点，并选择最适合你的方案。

---

一、部署模式概览

AskTable MCP Server 支持四种部署模式：

---

二、如何选择部署模式？

决策树

选择建议

选择 SaaS SSE，如果你：

• •✅ 数据库可以从公网访问
• •✅ 想要最简单的配置（无需安装）
• •✅ 个人使用或小团队
• •✅ 快速体验和测试

选择 SaaS Stdio，如果你：

• •✅ 数据库可以从公网访问
• •✅ 需要本地进程控制
• •✅ 习惯使用 Stdio 模式

选择本地 SSE，如果你：

• •✅ 数据库在内网，无法公网访问
• •✅ 需要多人使用（团队）
• •✅ 对数据安全有严格要求
• •✅ 需要统一管理和监控

选择本地 Stdio，如果你：

• •✅ 数据库在内网，无法公网访问
• •✅ 个人使用
• •✅ 需要离线工作
• •✅ 习惯使用 Stdio 模式

---

三、SaaS SSE 模式（推荐新用户）

1. 架构图

2. 优势

✅ 零安装：无需安装任何软件，直接使用 ✅ 配置简单：只需一个 URL ✅ 自动更新：服务端自动升级，无需手动维护 ✅ 高可用：云端服务，稳定可靠

3. 配置步骤

步骤 1：获取凭证

登录 AskTable，获取：

• •API Key（在"设置" → "API 密钥"中）
• •Datasource ID（在"数据源"列表中）

步骤 2：配置 Claude Desktop

编辑配置文件（claude_desktop_config.json）：

{
  "mcpServers": {
    "asktable": {
      "type": "sse",
      "url": "https://mcp.asktable.com/sse/?api_key=YOUR_API_KEY&datasource_id=YOUR_DATASOURCE_ID",
      "headers": {},
      "timeout": 300,
      "sse_read_timeout": 300
    }
  }
}

步骤 3：重启 Claude Desktop

保存配置后，重启 Claude Desktop 即可使用。

4. 参数说明

---

四、SaaS Stdio 模式

1. 架构图

2. 优势

✅ 本地进程：MCP Server 在本地运行，更好的控制 ✅ 日志可见：可以查看详细的运行日志 ✅ 调试方便：便于排查问题

3. 配置步骤

步骤 1：安装 MCP Server

使用 uv（推荐）：

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 测试安装
uvx asktable-mcp-server@latest --help

或使用 pip：

pip install asktable-mcp-server

步骤 2：配置 Claude Desktop

{
  "mcpServers": {
    "asktable": {
      "command": "uvx",
      "args": ["asktable-mcp-server@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "DATASOURCE_ID": "YOUR_DATASOURCE_ID"
      }
    }
  }
}

步骤 3：重启 Claude Desktop

4. 环境变量说明

---

五、本地 SSE 模式（推荐企业用户）

1. 架构图

2. 优势

✅ 数据安全：数据不出内网 ✅ 多人使用：支持团队共享 ✅ 统一管理：集中配置和监控 ✅ 高性能：内网直连，延迟低

3. 部署方式

方式 1：使用 AskTable All-in-One 镜像（推荐）

AskTable 的 All-in-One 镜像已经包含了 MCP SSE Server。

启动服务：

docker run -d \
  --name asktable \
  -p 8080:8080 \
  -e DATABASE_URL=postgresql://user:pass@host:5432/db \
  registry.cn-shanghai.aliyuncs.com/datamini/asktable:latest

MCP Server 地址：

http://your_server_ip:8080/mcp/sse/

配置 Claude Desktop：

{
  "mcpServers": {
    "asktable": {
      "type": "sse",
      "url": "http://your_server_ip:8080/mcp/sse/?api_key=YOUR_API_KEY&datasource_id=YOUR_DATASOURCE_ID",
      "headers": {},
      "timeout": 300,
      "sse_read_timeout": 300
    }
  }
}

方式 2：独立部署 MCP Server

使用 Docker：

docker run -d \
  --name asktable-mcp-server \
  -p 8095:8095 \
  -e API_KEY=your_api_key \
  -e DATASOURCE_ID=your_datasource_id \
  -e BASE_URL=http://your_asktable_server:8080/api \
  registry.cn-shanghai.aliyuncs.com/datamini/asktable-mcp-server:latest

MCP Server 地址：

http://your_server_ip:8095/sse/

配置 Claude Desktop：

{
  "mcpServers": {
    "asktable": {
      "type": "sse",
      "url": "http://your_server_ip:8095/sse/?api_key=YOUR_API_KEY&datasource_id=YOUR_DATASOURCE_ID",
      "headers": {},
      "timeout": 300,
      "sse_read_timeout": 300
    }
  }
}

4. 高级配置

使用 Nginx 反向代理：

server {
    listen 80;
    server_name mcp.your-company.com;

    location /mcp/ {
        proxy_pass http://localhost:8095/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_buffering off;
    }
}

配置 Claude Desktop：

{
  "mcpServers": {
    "asktable": {
      "type": "sse",
      "url": "http://mcp.your-company.com/mcp/sse/?api_key=YOUR_API_KEY&datasource_id=YOUR_DATASOURCE_ID",
      "headers": {},
      "timeout": 300,
      "sse_read_timeout": 300
    }
  }
}

---

六、本地 Stdio 模式

1. 架构图

2. 优势

✅ 完全本地：所有组件都在本地运行 ✅ 离线工作：无需网络连接 ✅ 数据安全：数据不出本地

3. 配置步骤

步骤 1：安装 MCP Server

uvx asktable-mcp-server@latest

步骤 2：配置 Claude Desktop

{
  "mcpServers": {
    "asktable": {
      "command": "uvx",
      "args": ["asktable-mcp-server@latest"],
      "env": {
        "API_KEY": "YOUR_API_KEY",
        "DATASOURCE_ID": "YOUR_DATASOURCE_ID",
        "BASE_URL": "http://localhost:8080/api"
      }
    }
  }
}

步骤 3：重启 Claude Desktop

---

七、配置对比

1. 功能对比

2. 性能对比

---

八、生产环境建议

1. 企业内网部署

推荐方案：本地 SSE 模式

部署架构：

[用户] → [Nginx] → [MCP Server] → [AskTable] → [数据库]

关键配置：

• •使用 HTTPS（配置 SSL 证书）
• •配置访问控制（IP 白名单）
• •启用日志记录和监控
• •配置备份和容灾

2. 个人/小团队

推荐方案：SaaS SSE 模式

优势：

• •无需维护服务器
• •自动更新和备份
• •高可用保证

3. 混合部署

场景：部分数据在云端，部分在内网

方案：配置多个 MCP Server

{
  "mcpServers": {
    "asktable-cloud": {
      "type": "sse",
      "url": "https://mcp.asktable.com/sse/?api_key=KEY1&datasource_id=DS1"
    },
    "asktable-local": {
      "type": "sse",
      "url": "http://internal-mcp:8095/sse/?api_key=KEY2&datasource_id=DS2"
    }
  }
}

---

九、故障排查

1. SSE 连接失败

症状：无法连接到 MCP Server

排查步骤：

1. •检查 URL 是否正确
2. •测试网络连接：curl -v URL
3. •检查防火墙设置
4. •查看服务器日志

2. Stdio 进程启动失败

症状：工具无法加载

排查步骤：

1. •手动运行命令测试：uvx asktable-mcp-server@latest
2. •检查环境变量是否正确
3. •查看 Claude Desktop 日志

3. 权限错误

症状：提示 API Key 无效

排查步骤：

1. •确认 API Key 正确
2. •检查 API Key 是否过期
3. •确认数据源 ID 正确
4. •检查网络连接

---

十、总结

选择合适的部署模式，需要考虑：

• •数据位置（云端 vs 内网）
• •使用场景（个人 vs 团队）
• •安全要求（数据安全 vs 便利性）
• •技术能力（配置难度 vs 维护成本）

快速决策：

• •🚀 快速体验 → SaaS SSE
• •🏢 企业内网 → 本地 SSE
• •💻 个人开发 → SaaS Stdio 或本地 Stdio

下一步：

• •MCP 使用指南 - 学习如何使用
• •MCP 架构与原理 - 深入理解技术

---

相关阅读：

• •MCP 入门指南
• •MCP 快速开始

技术交流：

• •官网: asktable.com