BlazeSQL MCP Server

BlazeSQL MCP サーバー

blaze-sql-server は、BlazeSQL の自然言語クエリ API 用に、デフォルトで安全性を重視した MCP サーバーおよび CLI です。

次の 2 つのモードに対応しています。

• serve：Cursor、Claude Desktop、Codex、その他の MCP クライアント向けに、MCP stdio サーバーとして実行します
• query：シェルから BlazeSQL リクエストを 1 件直接実行します

主な機能

• MCP ツール：blazesql_query を公開します
• CLI コマンド：serve、query、doctor、help、version
• セキュリティのデフォルト設定：リモートエンドポイントは HTTPS のみ、タイムアウトに上限を設定、ログの機密情報をマスキング、整形済み出力に上限を設定
• 検証：実行時の設定検証と BlazeSQL レスポンスの形式検証
• ツール：pnpm、CI、自動テスト、プロジェクトレベルの mcporter 設定

要件

• Node.js >=20.11.0
• pnpm >=10
• BlazeSQL API キー

インストール

pnpm install
cp .env.sample .env

少なくとも次を設定してください。

BLAZE_API_KEY=YOUR_API_KEY_HERE

任意の環境変数：

• BLAZE_API_ENDPOINT
• BLAZE_REQUEST_TIMEOUT_MS
• BLAZE_MAX_RESPONSE_CHARS
• BLAZE_LOG_LEVEL
• BLAZE_ALLOW_INSECURE_ENDPOINT

ビルド

pnpm build

MCP サーバーとして実行

後方互換性のため、引数なしでバイナリを実行すると、stdio サーバーが起動します。

node build/index.js

明示的に指定する場合：

node build/index.js serve

公開される MCP ツール：

• blazesql_query
• db_id：BlazeSQL データベース ID
• natural_language_request：BlazeSQL に送信するプロンプト

MCPorter で使用

MCPorter は、プロジェクトレベルの設定 config/mcporter.json を使用して、このサーバーを自動的に検出できます。

プロジェクトのルートから実行します。

npx mcporter list
npx mcporter call blazesql.blazesql_query db_id:"your_db_id" natural_language_request:"show me total users"

任意の場所からアドホックに使用する場合：

npx mcporter call --stdio "node /path/to/blaze-sql-mcp-server/build/index.js" --name blazesql blazesql.blazesql_query db_id:"your_db_id" natural_language_request:"total sales last month"

CLI として実行

ヘルプを表示します。

node build/index.js --help

クエリを直接実行します。

node build/index.js query --db-id db_demo --request "show me total users by city"

位置引数を使用します。

node build/index.js query db_demo "show me total users by city"

標準入力からリクエストを読み込みます。

printf 'show me total users by city\n' | node build/index.js query db_demo --stdin

使用可能な出力形式：

node build/index.js query db_demo "show me total users by city" --format markdown
node build/index.js query db_demo "show me total users by city" --format text
node build/index.js query db_demo "show me total users by city" --format json

診断

実行時の設定を確認します。

node build/index.js doctor
node build/index.js doctor --json

doctor は共有端末でも安全に実行できます。生の API キーが表示されることはありません。

検証

pnpm typecheck
pnpm test
pnpm check

MCP クライアントの設定

stdio コマンドの例：

/absolute/path/to/node /absolute/path/to/blaze-sql-mcp-server/build/index.js

バイナリはデフォルトで serve を実行するため、MCP クライアントで追加のサブコマンドを指定する必要はありません。

設計メモ

この CLI の構成は、mcporter などのツールで広く使われている、単一目的コマンドのパターンに意図的に沿っています。予測しやすいコマンド体系、シェルからの直接実行、そして必要な場面で明確に選べる機械可読モードを備えています。