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 分