hs-sql-agent

組み込みの管理パネルを備えた、リレーショナルデータベース向け HTTP MCP サーバーを簡単にデプロイできます。 hs-sql-agent を使用すると、Claude Desktop、Cursor、Visual Studio Code などの MCP クライアントからリレーショナルデータベースへ安全にアクセスできます。また、管理者はデータベース接続、MCP キー、権限、監査ログ、セキュリティポリシーを一元管理できます。 この Zeabur テンプレートでは、以下のサービスが自動的にデプロイされます。

• hs-sql-agent — MCP サーバーおよび管理パネル
• PostgreSQL — 内部管理用データベース
• Redis — キャッシュ、レート制限、同時実行制御、セキュリティポリシー同期

✨ 主な機能

• 🔌 HTTP MCP エンドポイント
• 🔑 クライアントごとの MCP アクセスキー
• 🗄️ 複数のデータベース接続管理
• 🔐 MCP キーごとのデータベース割り当て
• 🧰 MCP キーごとのツール権限
• 🚦 設定可能なレート制限
• 📋 SQL 実行監査ログ
• 🛡️ 一元化されたセキュリティポリシー
• ⚡ Redis を利用したキャッシュおよび同時実行制御
• 🖥️ 組み込みの Web 管理パネル
• 📋 そのままコピーできる MCP クライアント設定

🚀 はじめに

1. テンプレートをデプロイ

Zeabur でこのテンプレートをデプロイし、管理パネル用のサブドメインを設定します。 必要なサービスは Zeabur によって自動的に作成・接続されます。 デプロイ完了後、Zeabur のデプロイ手順に表示される Admin Panel URL を開きます。

2. 管理者アカウントを作成

初回起動時に、最初の管理者アカウントを作成します。 作成したアカウントで管理パネルにサインインしてください。

3. データベースを追加

DB Management を開き、MCP クライアントからアクセスさせたいリレーショナルデータベースを追加します。 MCP キーを発行する前に、データベース接続をテストすることを推奨します。

4. MCP アクセスキーを発行

以下を開きます。 Runtime Admin → MCP Keys 新しい MCP キーを作成し、アクセス設定を行います。 設定可能な項目には以下が含まれます。

• キー名
• 有効期限
• データベース
• レート制限
• 利用可能な MCP ツール
• 任意のデータアクセス制限
• 任意の CORS オリジン Test DB Connection をクリックして選択したデータベースへの接続を確認し、その後 Issue Key をクリックします。

5. MCP 設定をコピー

キーを発行すると、hs-sql-agent はすぐに Save and connect ダイアログを表示します。 このダイアログには以下が含まれます。

• 一度だけ表示される MCP キー
• MCP エンドポイント
• 対応 MCP クライアント向けの設定済み構成 利用するクライアントを選択します。
• Claude Desktop
• Cursor
• Visual Studio Code
• Generic HTTP その後、対応する Copy config ボタンをクリックし、コピーした設定を MCP クライアントへ貼り付けます。

⚠️ MCP キーの平文値は一度しか表示されません。 > > ダイアログを閉じる前に、キーまたは生成されたクライアント設定を必ず保存してください。ダイアログを閉じた後、Admin UI から平文のキーを再表示することはできません。 これで完了です。MCP エンドポイントや認証ヘッダーを手動で組み立てる必要はありません。

🔐 セキュリティ

MCP キーはパスワードと同様に秘密情報として扱ってください。 MCP キーを含む生成済み設定をソースコード管理へコミットしたり、公開 Issue やチケットへ貼り付けたり、第三者へ公開したりしないでください。 キーが漏洩した場合は、MCP Keys ページから該当キーを失効させ、新しいキーを発行してください。 本番環境のデータベースでは、利用する MCP ツールに必要な最小限の権限のみを持つ専用データベースアカウントを使用することを推奨します。

⚠️ プロジェクトステータス

hs-sql-agent は現在 活発に開発中 です。 リリース間で機能や設定項目が変更される可能性があり、バグが含まれている場合があります。 問題や機能要望がある場合はこちらからお知らせください。

• 🔗 GitHub Issues
• ⭐ GitHub Repository