CentralMind/Gateway

Official
by centralmind
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides integration with ClickHouse databases, automatically generating APIs optimized for analytical workloads and high-performance queries.

  • Provides Docker container deployment options for easy setup and consistent runtime environments.

  • Provides integration with ElasticSearch, enabling AI agents to query and search through data via automatically generated APIs.

🚀 GitHub コードスペースを介したインタラクティブなデモ

Centralmind/Gatewayとは

MCP または OpenAPI 3.1 プロトコルを介してデータベースを AI-Agent に公開する簡単な方法。

docker run --platform linux/amd64 -p 9090:9090 \ ghcr.io/centralmind/gateway:v0.2.6 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 エージェント内で使用できるもの:

ゲートウェイは AI に最適化された API を生成します。

Centralmind/Gatewayを選ぶ理由

AIエージェントやLLMを活用したアプリケーションは、高速かつ安全なデータアクセスを必要としますが、従来のAPIやデータベースはそうした用途には適していません。私たちは、構造化データ向けに安全でLLMに最適化されたAPIを自動生成するAPIレイヤーを構築しています。

私たちの解決策:

  • GDPR、CPRA、SOC 2、その他の規制への準拠を確実にするために、PII と機密データをフィルタリングします。
  • トレーサビリティと監査機能を追加し、AIアプリケーションがブラックボックスにならないようにし、セキュリティチームが制御を維持できるようにします。
  • AI ワークロード向けに最適化され、AI エージェントが API を理解できるように強化されたメタ情報を備えたモデル コンテキスト プロトコル (MCP) をサポートするほか、キャッシュ機能とセキュリティ機能が組み込まれています。

当社の主なユーザーは、顧客サポートや分析のために AI エージェントを導入している企業です。セキュリティ、コンプライアンス、パフォーマンスのリスクを伴うデータベースへの直接 SQL アクセスなしでデータにアクセスするためのモデルを必要としています。

特徴

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

仕組み

1. 接続と発見

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

2. デプロイ

ゲートウェイは、スタンドアロンバイナリ、Docker、Kubernetesなど、複数のデプロイメントオプションをサポートしています。詳細な手順については、起動ガイドをご覧ください。システムはYAML構成とプラグインを使用して簡単にカスタマイズできます。

3. 使用と統合

REST APIまたはモデルコンテキストプロトコル(MCP)を介してデータにアクセスし、セキュリティ機能を内蔵しています。Gatewayは、MCPを介した関数呼び出しやカーソル機能を使用して、LangChain、OpenAI、Claude DesktopなどのAIモデルやアプリケーションとシームレスに統合できます。また、ローカルまたはリモートの宛先にOtel形式でテレメトリを設定することもできます。

ドキュメント

はじめる

  • クイックスタートガイド
  • インストール手順
  • API生成ガイド
  • API 起動ガイド

追加リソース

  • ChatGPT統合ガイド
  • データベースコネクタのドキュメント
  • プラグインのドキュメント

構築方法

# 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生成

ゲートウェイはLLMモデルを使用してAPI構成を生成します。以下の手順に従ってください。

  1. サポートされている AI プロバイダーのいずれかを選択してください。

Google Gemini は、無料枠を豊富に提供しています。API キーは Google AI Studio から取得できます。

ログイン後、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 rest

Dockerコンポーズ

docker compose -f ./example/simple/docker-compose.yml up

MCPプロトコル統合

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

  1. ゲートウェイバイナリをビルドします。
go build .
  1. Claude デスクトップ ツールの構成を構成します。
{ "mcpServers": { "gateway": { "command": "PATH_TO_GATEWAY_BINARY", "args": ["start", "--config", "PATH_TO_GATEWAY_YAML_CONFIG", "mcp-stdio"] } } }

ロードマップ

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

データベースと接続性

  • 🗄️拡張データベース統合- Redshift、S3 (Iceberg および Parquet)、Oracle DB、Microsoft SQL Server、Elasticsearch
  • 🔑 SSH トンネリング- ジャンプホストまたは SSH 要塞を使用して接続をトンネリングする機能

強化された機能

  • 🔍高度なクエリ機能- 複雑なフィルタリング構文と集計関数をパラメータとして使用可能
  • 🔐強化された MCP セキュリティ- API キーと OAuth 認証

プラットフォームの改善

  • 📦スキーマ管理- 自動化されたスキーマ進化と API バージョン管理
  • 🚦高度なトラフィック管理- インテリジェントなレート制限、リクエストスロットリング
  • ✍️書き込み操作のサポート- 挿入、更新操作
-
security - not tested
A
license - permissive license
-
quality - not tested

LLMおよびAIエージェント向けに最適化されたデータベースからのMCPサーバー。PostgreSQL、MySQL、ClickHouse、Snowflake、MSSQL、BigQuery、Oracle Database、SQLite、ElasticSearch、DuckDBをサポート

  1. Why Centralmind/Gateway
    1. Features
      1. How it Works
        1. 1. Connect & Discover
        2. 2. Deploy
        3. 3. Use & Integrate
      2. Documentation
        1. Getting Started
        2. Additional Resources
      3. How to Build
        1. API Generation
          1. Running the API
            1. Run locally
            2. Docker Compose
            3. MCP Protocol Integration
          2. Roadmap
            1. Database and Connectivity
            2. Enhanced Functionality
            3. Platform Improvements
          ID: tkhdp69cyc