SQLBot MCP Proxy

SQLBot MCP Proxy

SQLBot 用の MCP サーバープロキシです。SQLBot のデータソース検索、テーブルメタデータ、自然言語による Text-to-SQL の質問、ローカルでのフォールバックレポート生成を MCP ツールとして公開します。

要件

• Docker
• 稼働中の SQLBot サービス
• SQLBot API キー

推奨 Codex 設定

このリポジトリを手動でダウンロードする必要はありません。Codex の設定にこの MCP サーバーを追加し、SQLBot の URL とキーを置き換えてください。

[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 = true
startup_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>"

その後、Codex を完全に再起動してください。

SQLBot が別のパブリックアドレスまたは LAN アドレスから到達可能な場合は、SQLBOT_MCP_PROXY_BASE_URL をそのアドレスに置き換えてください。例：https://sqlbot.example.com または http://192.168.1.10:18088。

プロンプトテンプレート

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.

Docker でのクイックテスト

Codex の外部でイメージをテストできます。

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

ツール

• sqlbot_list_datasources：設定された API キーから参照できる SQLBot データソースを一覧表示します
• sqlbot_list_tables：データソースに関連付けられた、チェック済みの SQLBot メタデータテーブルを一覧表示します
• sqlbot_describe_table：SQLBot メタデータテーブルのチェック済みフィールドを説明します
• sqlbot_ask_data：自然言語でデータに関する質問を SQLBot に送信します
• sqlbot_generate_report：分析レポートとグラフを生成します。ローカルの SVG フォールバックを利用できます

環境変数

名前	デフォルト値	説明
SQLBOT_MCP_PROXY_BASE_URL	http://183.196.108.32:18088	SQLBot サービスのベース URL
SQLBOT_MCP_PROXY_ACCESS_KEY	empty	SQLBot API アクセスキー
SQLBOT_MCP_PROXY_SECRET_KEY	empty	SQLBot API シークレットキー
FEISHU_ASK_ACCESS_KEY	empty	フォールバック用アクセスキー名
FEISHU_ASK_SECRET_KEY	empty	フォールバック用シークレットキー名
SQLBOT_MCP_PROXY_DOCKER_CONTAINER	sqlbot	フォールバックキーの検索に使用するコンテナ
SQLBOT_MCP_PROXY_HTTP_HOST	127.0.0.1	HTTP モードのホスト
SQLBOT_MCP_PROXY_HTTP_PORT	8787	HTTP モードのポート
SQLBOT_MCP_PROXY_HTTP_PATH	/mcp	HTTP モードの JSON-RPC パス
SQLBOT_MCP_PROXY_HTTP_TIMEOUT_MS	120000	SQLBot HTTP リクエストのタイムアウト
SQLBOT_MCP_PROXY_REPORT_OUTPUT_DIR	outputs	フォールバック用に生成した SVG レポートの出力ディレクトリ

HTTP モードの詳細設定

ほとんどの MCP クライアントでは stdio を使用してください。HTTP 経由で JSON-RPC を送信できるクライアントの場合は、次を実行します。

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

ヘルスチェック：

curl http://127.0.0.1:8787/health

公開

1. package.json のパッケージメタデータを確認します。
2. OCI イメージを公開します。

docker build -t ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0 .
docker push ghcr.io/wenrou21/sqlbot-mcp-proxy:0.1.0

3. MCP Registry のメタデータを公開します。

mcp-publisher login github
mcp-publisher publish

package.json の mcpName は、server.json の name と完全に一致している必要があります。