mcpField
D
Database Gateway

Database Gateway

ローカル
centralmind.aiデータベース54867 週間前に更新

Database Gateway について

Database Gateway(CentralMind Gateway)は、PostgreSQL、MySQL、ClickHouse などのデータベースを MCP サーバーや REST API として公開する汎用の MCP サーバーです。PII のフィルタリングや監査を伴って、AI エージェントから構造化データへアクセスさせたいチーム向けです。

主な機能

  1. 01データベーススキーマからの API 自動生成
  2. 02多数のデータベースと MCP・REST に対応
  3. 03プラグインによる PII 除去機能
  4. 04OpenTelemetry による監視と監査証跡
  5. 05Lua スクリプトによる行レベルセキュリティ

活用シーン

  1. 01開発時に LLM からデータベースを照会・更新
  2. 02データウェアハウスへの自然言語での問い合わせ

MCP 対応

本プロジェクトは、データベースのデータを SSE または stdio 経由の MCP として Claude Desktop や Cursor などのクライアントに提供する MCP サーバーです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"gateway": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"\\"
]
}
}
}
起動コマンドdocker run -i --rm '\'

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
oci\

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Build Binaries   README の画像   README の画像    README の画像   README の画像

CentralMind Gateway:数分で API または MCP サーバーを作成

🚀 インタラクティブなデモはこちら:https://centralmind.ai

Centralmind/Gateway とは

MCP または OpenAPI 3.1 プロトコルを通じて、データベースを AI エージェントに公開する簡単な方法です。

docker run --platform linux/amd64 -p 9090:9090 \
  ghcr.io/centralmind/gateway:v0.2.18 start \
  --connection-string "postgres://db-user:db-password@db-host/db-name?sslmode=require"

これにより、次の API が実行されます。

INFO Gateway server started successfully!         
INFO MCP SSE server for AI agents is running at: http://localhost:9090/sse 
INFO REST API with Swagger UI is available at: http://localhost:9090/ 

これを AI エージェント内で使用できます。

mcp-raw-cursor-setup.png

Gateway は AI に最適化された API を生成します。

Centralmind/Gateway を選ぶ理由

AI エージェントと LLM を活用したアプリケーションには、データへの高速で安全なアクセスが必要です。構造化データ向けに、LLM に最適化された安全な API を自動生成する API レイヤーを開発しています。

  • MCP または OpenAPI ですぐに開始するか、Direct/Raw SQL API を使用できます
  • PII や機密データを除外し、GDPR、CPRA、SOC 2 などの規制への準拠を確保します
  • トレーサビリティと監査機能を追加し、AI アプリケーションがブラックボックス化するのを防ぎ、セキュリティチームが管理を維持できるようにします
  • AI ワークロード向けに最適化されています。AI エージェントが API を理解できるよう、メタデータを強化した Model Context Protocol(MCP)をサポートし、キャッシュ機能とセキュリティ機能も組み込まれています

LLM がデータベース内のデータを作成、調整、またはクエリする必要がある開発時に役立ちます。 分析用途では、データベースやデータウェアハウスとチャットできます。 リモートの関数/ツール呼び出しを使って、データベースのデータで AI エージェントを強化できます。

demo

特長

  • ⚡ API の自動生成 – テーブルスキーマとサンプルデータに基づいて、LLM を使用して API を自動生成します
  • 🗄️ 構造化データベースのサポート – PostgreSQL、MySQL、ClickHouse、Snowflake、MSSQL、BigQuery、Oracle Database、SQLite、ElasticSearchをサポートします
  • 🌍 複数のプロトコルをサポート – SSE モードを含む REST または MCP サーバーとして API を提供します
  • 🔐 認証オプション – API キーとOAuthを標準でサポートします
  • 🔒 PII 保護 – PII や機密データのマスキングに、正規表現プラグインまたはMicrosoft Presidio プラグインを使用します
  • 👀 包括的なモニタリング – リクエストの追跡と監査証跡のためにOpenTelemetry (OTel)と連携します
  • 📦 ローカルおよびオンプレミス – 設定可能な AI エンドポイントとモデルを通じて、セルフホスト可能な LLMをサポートします
  • 🤖 複数の AI プロバイダーをサポート - OpenAI、Anthropic、Amazon Bedrock、Google Gemini、Google VertexAIをサポートします
  • ⚡ 柔軟な設定 – YAML 設定とプラグインシステムにより、簡単に拡張できます
  • 📜 API ドキュメント – Swagger ドキュメントと OpenAPI 3.1.0 仕様を自動生成します
  • 🔑 行レベルセキュリティ(RLS) – Lua スクリプトを使用して、きめ細かなデータアクセス制御を行います
  • 🏎️ パフォーマンスの最適化 – 時間ベースのキャッシュとLRU キャッシュ戦略を実装します

動作の仕組み

img.png

1. 接続と検出

Gateway は PostgreSQL などの構造化データベースに接続し、スキーマとサンプルデータを自動的に分析して、プロンプトに基づく最適化された API 構造を生成します。LLM は検出段階でのみ使用され、API 設定を生成します。 ツールはAI プロバイダーを使用して API 設定を生成し、PII 検出によってセキュリティを確保します。

2. デプロイ

Gateway は、スタンドアロンバイナリ、Docker、Kubernetesなど、複数のデプロイ方法をサポートしています。詳しい手順については、起動ガイドをご確認ください。 システムでは、簡単にカスタマイズできるよう、YAML 設定とプラグインを使用します。

3. 使用と統合

組み込みのセキュリティ機能を使用して、REST API または Model Context Protocol(MCP)経由でデータにアクセスできます。 Gateway は、関数呼び出しを使用してLangChain、 OpenAI、Claude Desktopなどの AI モデルやアプリケーションとシームレスに連携します。また、MCP 経由でCursorとも連携します。さらに、テレメトリを設定して、ローカルまたはリモートの送信先に otel 形式で送信することもできます。

ドキュメント

はじめに
その他のリソース

ビルド方法

# Clone the repository
git clone https://github.com/centralmind/gateway.git

# Navigate to project directory
cd gateway

# Install dependencies
go mod download

# Build the project
go build .

API 生成

Gateway は LLM モデルを使用して API 設定を生成します。次の手順に従ってください。

サポート対象の AI プロバイダーから 1 つ選択します。

Google Gemini には充実した無料枠があります。Google AI Studio にアクセスして API キーを取得できます。

ログイン後、AI Studio の API セクションで API キーを作成できます。無料枠には十分な月間トークン割り当てが含まれているため、開発やテストに利用できます。

AI プロバイダーの認証を設定します。Google Gemini の場合は、API キーを設定します。

export GEMINI_API_KEY='yourkey'
  1. ディスカバリーコマンドを実行します。
./gateway discover \
  --ai-provider gemini \
  --connection-string "postgresql://neondb_owner:MY_PASSWORD@MY_HOST.neon.tech/neondb?sslmode=require" \
  --prompt "Generate for me awesome readonly API"
  1. 生成処理をお楽しみください。
INFO 🚀 API Discovery Process
INFO Step 1: Read configs
INFO ✅ Step 1 completed. Done.

INFO Step 2: Discover data
INFO Discovered Tables:
INFO   - payment_dim: 3 columns, 39 rows
INFO   - fact_table: 9 columns, 1000000 rows
INFO ✅ Step 2 completed. Done.

# Additional steps and output...

INFO ✅ All steps completed. Done.

INFO --- Execution Statistics ---
INFO Total time taken: 1m10s
INFO Tokens used: 16543 (Estimated cost: $0.0616)
INFO Tables processed: 6
INFO API methods created: 18
INFO Total number of columns with PII data: 2
  1. gateway.yaml 内の生成された設定を確認します。
api:
  name: Awesome Readonly API
  description: ''
  version: '1.0'
database:
  type: postgres
  connection: YOUR_CONNECTION_INFO
  tables:
    - name: payment_dim
      columns: # Table columns
      endpoints:
        - http_method: GET
          http_path: /some_path
          mcp_method: some_method
          summary: Some readable summary
          description: 'Some description'
          query: SQL Query with params
          params: # Query parameters

API の実行

ローカルで実行
./gateway start --config gateway.yaml
Docker Compose
docker compose -f ./example/simple/docker-compose.yml up
MCP プロトコルとの統合

Gateway は MCP プロトコルを実装しており、Claude やその他のツールとシームレスに統合できます。詳細な設定手順については、Claude 統合ガイドをご覧ください。

MCP ツールを Claude Desktop に追加するには、Claude の設定を調整します。

{
  "mcpServers": {
    "gateway": {
      "command": "PATH_TO_GATEWAY_BINARY",
      "args": ["start", "--config", "PATH_TO_GATEWAY_YAML_CONFIG", "mcp-stdio"]
    }
  }
}

ロードマップ

ロードマップは常に変更される可能性があり、その内容はユーザーからのフィードバックに大きく左右されます。現時点では、次の機能を計画しています。

データベースと接続性
  • 🗄️ データベース統合の拡張 - Databricks、Redshift、S3(Iceberg および Parquet)、Oracle DB、Microsoft SQL Server、Elasticsearch
  • 🔑 SSH トンネリング - ジャンプホストまたは SSH バスティオンを使用した接続のトンネリング
機能の強化
  • 🔍 高度なクエリー機能 - 複雑なフィルタリング構文とパラメーターとしての集計関数
  • 🔐 MCP セキュリティの強化 - API キーおよび OAuth 認証
プラットフォームの改善
  • 📦 スキーマ管理 - スキーマの自動進化と API バージョン管理
  • 🚦 高度なトラフィック管理 - インテリジェントなレート制限、リクエストのスロットリング
  • ✍️ 書き込み操作のサポート - 挿入、更新操作

MCP レジストリのデータベースゲートウェイ

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。