SQLPad MCP Server

SQLPad 用の MCP サーバーです。AI エージェントを SQLPad インスタンスのベース URL とサービス トークンに向けると、エージェントは接続の検出、スキーマの検査、SQL の実行、保存済みクエリの管理を行うことができます。

要件

• Node.js 20 以降。

• 到達可能な SQLPad インスタンス。

• SQLPad サーバーには SQLPAD_SERVICE_TOKEN_SECRET が設定されている必要があります。これがないと、Bearer 認証されたすべてのリクエストは 401 Unauthorized を返します。

• SQLPad 管理 GUI で生成されたサービス トークン。

Related MCP server: SQLite Database MCP Server

クイックスタート

インストール手順は不要です。npm から直接実行できます:

SQLPAD_SERVICE_TOKEN=... npx sqlpad-mcp --base-url https://sqlpad.example.com

または、グローバルにインストールします:

npm install -g sqlpad-mcp

サーバーは stdio 経由で MCP を話すため、通常は手動ではなく MCP クライアントによって起動されます。直接実行しても資格情報の確認には役立ちます。成功すると、検出された SQLPad のバージョンが stderr に記録されます。

構成

CLI フラグは対応する環境変数よりも優先されます。バッチのポーリング間隔 (250 ms) は内部的なものであり、設定できません。

Claude Code の構成

サーバーを Claude Code の mcp.json に追加します:

{
  "mcpServers": {
    "sqlpad": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sqlpad-mcp",
        "--base-url",
        "https://sqlpad.example.com"
      ],
      "env": {
        "SQLPAD_SERVICE_TOKEN": "..."
      }
    }
  }
}

env を通じてトークンを指定すると、プロセス引数リストから除外されます。プロセス引数リストは ps で誰でも読み取れるためです。

ゲートされたツール グループを有効にするには、同じ env ブロックに "SQLPAD_ALLOW_WRITES": "true" または "SQLPAD_ALLOW_ADMIN": "true" を追加します。

ツール

12 個のツールは常に登録されます。さらに 6 個は 2 つの SQLPAD_ALLOW_* フラグの背後にあり、デフォルトではオフになっています。

実行

検出

保存済みクエリ

保存済みクエリの書き込み — SQLPAD_ALLOW_WRITES=true が必要

管理者 — SQLPAD_ALLOW_ADMIN=true が必要

これらは、管理者サービス トークンを必要とする SQLPad エンドポイントを呼び出します。

SQL 実行の仕組み

SQLPad は非同期バッチを通じて SQL を実行します。バッチの作成は即座に返され、各ステートメントは queued から started に移行し、その後 finished または error になります。結果はステートメントごとに個別に取得され、そのステートメントが完了するまで利用できません。

run_sql ツールは、作成、ポーリング、取得、行の返却という完全なプロトコルを吸収するため、エージェントは 1 回の呼び出しで済みます。ポーリングが設定されたタイムアウトに達すると、ツールは batchId を返し、エージェントはハングせずに再開できます。

接続にはデフォルト データベースがない場合があります。テーブル名は schema.table のように修飾し、get_connection_schema を使用して利用可能なスキーマを確認してください。

セキュリティ

• run_sql は DDL や DML を含む任意の SQL を実行し、サンドボックス化されていません。SQLPAD_ALLOW_WRITES は SQLPad 自身の保存済みクエリ オブジェクトの変更のみを制限し、SQL コンテンツを制限するものではありません。SQLPad 接続自体には読み取り専用のデータベース資格情報を使用してください。それが唯一の実際の強制手段です。

• SQLPad の /api/service-tokens エンドポイントは意図的に公開されていません。資格情報を発行するツールは権限昇格のプリミティブです。

• 管理者ツールはデフォルトでオフです。

• サービス トークンはすべてのエラーとログから編集されます。stdout は JSON-RPC チャネルであるため、すべてのログは stderr に出力されます。

• バッチはトークン自身のユーザーにスコープされるため、サーバーは常に自身のクエリ履歴のみを参照します。

コントリビューション

リポジトリをクローンして依存関係をインストールします:

git clone https://github.com/VAIBHAV7500/sqlpad-mcp.git
cd sqlpad-mcp
npm install
npm run build

変更用のブランチを作成します。プル リクエストを開く前に、次を実行します:

npm run typecheck && npm run lint && npm test

CI は Node 20 と 22 で同じ 3 つのコマンドを実行します。

ライセンス

MIT