SQLBot MCP Proxy

io.github.wenRou21由 GitHub 账号 wenRou21 发布v0.1.0更新于 Oct 24, 2026

MCP server proxy for SQLBot Text-to-SQL queries and report generation.

已验证STDIO仅桌面数据库数据与分析

概览

AI 生成的概览

代理型 MCP 服务器，让助手浏览 SQLBot 数据源与数据表、用自然语言提问数据问题，并生成分析报告。

可以做什么
  • 列出当前 API 密钥可见的 SQLBot 数据源
  • 列出某数据源中已勾选的元数据表，并查看表的字段信息
  • 向 SQLBot 提出自然语言数据问题（Text-to-SQL）
  • 生成分析报告与图表，失败时在本地输出目录生成 SVG 备用报告
适用场景
适合已经运行 SQLBot 服务、希望助手用自然语言查询其数据、先查看表元数据再提问，并快速产出分析报告或图表的场景，无需手写 SQL。
运行要求
需要 Docker，服务器以 OCI 镜像 ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0 通过 docker run 运行。需要可访问的 SQLBot 服务地址（SQLBOT_MCP_PROXY_BASE_URL），以及 SQLBot API 凭据 SQLBOT_MCP_PROXY_ACCESS_KEY 和 SQLBOT_MCP_PROXY_SECRET_KEY。可选使用 FEISHU_ASK_ACCESS_KEY 与 FEISHU_ASK_SECRET_KEY 作为备用密钥，或从 SQLBOT_MCP_PROXY_DOCKER_CONTAINER 指定的运行中容器读取密钥。
安装前请注意
需要 SQLBot 的访问密钥与密钥，并以环境变量形式传入容器；README 示例配置中还写有一个公网 IP 地址，应替换为自己的服务地址。查询与报告请求会发送到所配置的 SQLBot 服务，数据会离开本机。备用 SVG 报告会写入本地输出目录。可选的容器密钥读取功能会从运行中的 Docker 容器获取凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 SQLBot MCP Proxy，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

SQLBot MCP Proxy

MCP server proxy for SQLBot. It exposes SQLBot datasource discovery, table metadata, natural-language Text-to-SQL questions, and local fallback report generation as MCP tools.

Requirements

  • Docker
  • A running SQLBot service
  • SQLBot API keys

Recommended Codex Config

Users do not need to download this repository manually. Add this single MCP server to Codex config and replace the SQLBot URL and keys:

toml
[mcp_servers.sqlbot]command = "docker"args = [  "run",  "--rm",  "-i",  "-e",  "SQLBOT_MCP_PROXY_BASE_URL",  "-e",  "SQLBOT_MCP_PROXY_ACCESS_KEY",  "-e",  "SQLBOT_MCP_PROXY_SECRET_KEY",  "ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0"]enabled = truestartup_timeout_sec = 120
[mcp_servers.sqlbot.env]SQLBOT_MCP_PROXY_BASE_URL = "http://183.196.108.32:18088"SQLBOT_MCP_PROXY_ACCESS_KEY = "<YOUR_SQLBOT_ACCESS_KEY>"SQLBOT_MCP_PROXY_SECRET_KEY = "<YOUR_SQLBOT_SECRET_KEY>"

Then restart Codex completely.

If SQLBot is reachable through another public or LAN address, replace SQLBOT_MCP_PROXY_BASE_URL with that address, for example https://sqlbot.example.com or http://192.168.1.10:18088.

Prompt Template

text
Please configure SQLBot MCP for Codex.
MCP image:ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0
My SQLBot URL:http://183.196.108.32:18088
My SQLBot access key:<YOUR_SQLBOT_ACCESS_KEY>
My SQLBot secret key:<YOUR_SQLBOT_SECRET_KEY>
Add this MCP to Codex config:- MCP name: sqlbot- command: docker- args: ["run", "--rm", "-i", "-e", "SQLBOT_MCP_PROXY_BASE_URL", "-e", "SQLBOT_MCP_PROXY_ACCESS_KEY", "-e", "SQLBOT_MCP_PROXY_SECRET_KEY", "ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0"]- startup_timeout_sec: 120- SQLBOT_MCP_PROXY_BASE_URL: use the SQLBot URL above- SQLBOT_MCP_PROXY_ACCESS_KEY: use the access key above- SQLBOT_MCP_PROXY_SECRET_KEY: use the secret key above
After configuration, remind me to fully restart Codex.
After restart:- Check available datasources with sqlbot_list_datasources.- Use sqlbot_list_tables and sqlbot_describe_table before asking data questions.- Use sqlbot_ask_data for Text-to-SQL questions.- Use sqlbot_generate_report when I ask for an analysis report or chart.

Quick Docker Test

You can test the image outside Codex:

bash
docker run --rm -i \  -e SQLBOT_MCP_PROXY_BASE_URL=http://183.196.108.32:18088 \  -e SQLBOT_MCP_PROXY_ACCESS_KEY=your-access-key \  -e SQLBOT_MCP_PROXY_SECRET_KEY=your-secret-key \  ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0

Tools

  • sqlbot_list_datasources: list SQLBot datasources visible to the configured API key
  • sqlbot_list_tables: list checked SQLBot metadata tables for a datasource
  • sqlbot_describe_table: describe checked fields for a SQLBot metadata table
  • sqlbot_ask_data: ask SQLBot a natural-language data question
  • sqlbot_generate_report: generate an analysis report and chart, with a local SVG fallback

Environment Variables

NameDefaultDescription
SQLBOT_MCP_PROXY_BASE_URLhttp://183.196.108.32:18088SQLBot service base URL
SQLBOT_MCP_PROXY_ACCESS_KEYemptySQLBot API access key
SQLBOT_MCP_PROXY_SECRET_KEYemptySQLBot API secret key
FEISHU_ASK_ACCESS_KEYemptyFallback access key name
FEISHU_ASK_SECRET_KEYemptyFallback secret key name
SQLBOT_MCP_PROXY_DOCKER_CONTAINERsqlbotContainer used for fallback key lookup
SQLBOT_MCP_PROXY_HTTP_HOST127.0.0.1HTTP mode host
SQLBOT_MCP_PROXY_HTTP_PORT8787HTTP mode port
SQLBOT_MCP_PROXY_HTTP_PATH/mcpHTTP mode JSON-RPC path
SQLBOT_MCP_PROXY_HTTP_TIMEOUT_MS120000SQLBot HTTP request timeout
SQLBOT_MCP_PROXY_REPORT_OUTPUT_DIRoutputsDirectory for generated fallback SVG reports

Advanced HTTP Mode

Most MCP clients should use stdio. For clients that can send JSON-RPC over HTTP, start:

bash
docker run --rm -p 8787:8787 \  -e SQLBOT_MCP_PROXY_BASE_URL=http://183.196.108.32:18088 \  -e SQLBOT_MCP_PROXY_ACCESS_KEY=your-access-key \  -e SQLBOT_MCP_PROXY_SECRET_KEY=your-secret-key \  -e SQLBOT_MCP_PROXY_HTTP_HOST=0.0.0.0 \  ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0 --http

Health check:

bash
curl http://127.0.0.1:8787/health

Publish

  1. Confirm package metadata in package.json.
  2. Publish an OCI image:
bash
docker build -t ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0 .docker push ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0
  1. Publish MCP Registry metadata:
bash
mcp-publisher login githubmcp-publisher publish

The mcpName in package.json must exactly match name in server.json.

来源：README.md，提交 1e66dcf

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分