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

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

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

一、部署模式概览

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

模式	服务位置	通信协议	安装要求	适用场景
SaaS SSE	云端	SSE	无需安装	个人用户、快速体验
SaaS Stdio	云端	Stdio	需要安装包	需要本地进程控制
本地 SSE	本地	SSE	需要部署服务	企业内网、数据安全
本地 Stdio	本地	Stdio	需要安装包	本地开发、离线使用

二、如何选择部署模式？

决策树

加载图表中...

选择建议

选择 SaaS SSE，如果你：

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

选择 SaaS Stdio，如果你：

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

选择本地 SSE，如果你：

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

选择本地 Stdio，如果你：

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

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

1. 架构图

加载图表中...

2. 优势

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

3. 配置步骤

步骤 1：获取凭证

•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. 参数说明

参数	说明	默认值	建议值
`api_key`	AskTable API 密钥	必需	-
`datasource_id`	数据源 ID	必需	-
`timeout`	请求超时（秒）	300	300-600
`sse_read_timeout`	SSE 连接超时（秒）	300	300-600

四、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. 环境变量说明

变量	说明	必需
`API_KEY`	AskTable API 密钥	✅
`DATASOURCE_ID`	数据源 ID	✅
`BASE_URL`	自定义 API 地址	❌

五、本地 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. 功能对比

功能	SaaS SSE	SaaS Stdio	本地 SSE	本地 Stdio
零安装	✅	❌	❌	❌
数据安全	⚠️	⚠️	✅	✅
多人使用	✅	❌	✅	❌
离线工作	❌	❌	⚠️	✅
配置难度	⭐	⭐⭐	⭐⭐⭐	⭐⭐
维护成本	⭐	⭐	⭐⭐⭐	⭐⭐

2. 性能对比

指标	SaaS SSE	SaaS Stdio	本地 SSE	本地 Stdio
连接延迟	中	低	低	低
查询延迟	中	中	低	低
并发能力	高	低	高	低
稳定性	高	中	中	中

八、生产环境建议

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

排查步骤：

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

2. Stdio 进程启动失败

症状：工具无法加载

排查步骤：

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

3. 权限错误

症状：提示 API Key 无效

排查步骤：

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

十、总结

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

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

快速决策：

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

下一步：

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

相关阅读：

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

技术交流：

•官网: asktable.com

加入 AskTable 社群

咨询我们

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

一、部署模式概览

二、如何选择部署模式？

决策树

选择建议

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

1. 架构图

2. 优势

3. 配置步骤

4. 参数说明

四、SaaS Stdio 模式

1. 架构图

2. 优势

3. 配置步骤

4. 环境变量说明

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

1. 架构图

2. 优势

3. 部署方式

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

方式 2：独立部署 MCP Server

4. 高级配置

六、本地 Stdio 模式

1. 架构图

2. 优势

3. 配置步骤

七、配置对比

1. 功能对比

2. 性能对比

八、生产环境建议

1. 企业内网部署

2. 个人/小团队

3. 混合部署

九、故障排查

1. SSE 连接失败

2. Stdio 进程启动失败

3. 权限错误

十、总结