【MCP Server】Gemini CLI からAlloyDB のデータにリアルタイムで接続する方法

CData Connect AI のリモートMCP Server を活用し、Gemini CLI からAlloyDB に安全にアクセスして、データの読み取りやアクション実行を可能にします。

Gemini CLI は、Google のGemini AI モデルへのアクセスを提供するコマンドラインインターフェースツールです。コード生成、テキスト分析、会話型AI 機能を利用できます。コーディングで活用している方も多いのではないでしょうか。CData Connect AI と組み合わせることで、Gemini CLI をAlloyDB とリアルタイムに連携できるようになります。この記事では、Connect AI を使用したAlloyDB への接続方法と、AlloyDB と対話するためのGemini CLI の構成手順をご紹介します。

CData Connect AI は、AlloyDB のデータに接続するための専用クラウド間インターフェースを提供します。CData Connect AI Remote MCP Server により、Google ADK エージェントと AlloyDBの間でセキュアな通信が可能になります。これにより、ネイティブ対応データベースへのデータレプリケーションを必要とせずに、エージェントから AlloyDB のデータの読み取りや操作を実行できます。CData Connect AIは最適化されたデータ処理機能を備えており、フィルタや JOIN を含むサポート対象のすべての SQL 操作を効率的に AlloyDBへ直接送信します。サーバーサイド処理を活用することで、要求されたAlloyDB のデータ を迅速に取得できます。

ステップ1: Gemini CLI 用の AlloyDB 接続を構成

それでは早速、Gemini CLI から AlloyDB への接続を設定していきましょう。Gemini CLI から AlloyDB と対話するには、まずCData Connect AI でAlloyDB 接続を作成して構成します。

  1. Connect AI にログインし、「Connections」をクリックして「 Add Connection」をクリックします
  2. 「Add Connection」パネルから「AlloyDB」を選択します
  3. AlloyDB に接続するために必要な認証情報を入力しましょう。

    AlloyDB 接続プロパティの取得・設定方法

    AlloyDB に接続するには、次の接続プロパティが必要です。

    • Server：AlloyDB データベースをホスティングしているサーバーのホスト名またはIP アドレス。
    • Port（オプション）：AlloyDB データベースをホスティングしているサーバーのポート。このプロパティはデフォルトで5432に設定されます。
    • User：AlloyDB サーバーに認証する際に使われるユーザー。
    • Password：AlloyDB サーバーに認証する際に使われるパスワード。
    • Database（オプション）：AlloyDB サーバーに接続する場合のデータベース。設定されていない場合は、ユーザーのデフォルトデータベースが使用されます。

    AlloyDB への認証

    標準認証

    標準認証（事前に提供されたユーザーとパスワードの組み合わせを使用）は、デフォルトの認証形式です。

    標準認証で接続する場合は、これ以上のアクションは必要ありません。

    pg_hba.conf 認証スキーム

    CData 製品がサポートしている他の認証方法では、AlloyDB サーバー上のpg_hba.conf ファイルで有効化する必要があります。

    AlloyDB サーバーでの認証の設定については、こちらを参照してください。

    MD5

    pg_hba.conf ファイルのauth-method をmd5 に設定すると、MD5 パスワード検証を使用して認証できます。

    SASL

    CData 製品は、SASL（特にSCRAM-SHA-256）でパスワードを検証することで認証できます。

    この認証方法を使用するには、pg_hba.conf ファイルのauth-method をscram-sha-256 に設定します。

    Kerberos

    Kerberos 認証は、CData 製品が接続を試行している際にAlloyDB サーバーで開始されます。この認証方法を有効化するには、AlloyDB サーバーでKerberos を設定します。AlloyDB サーバーでのKerberos 認証の設定を完了したら、CData 製品からKerberos 認証を行う方法については、ヘルプドキュメントの「Kerberos の使用」セクションを参照してください。 「Create & Test」をクリックします

  4. 「Add AlloyDB Connection」ページの「Permissions」タブに移動し、ユーザーベースの権限を更新します。

パーソナルアクセストークンを追加する

パーソナルアクセストークン (PAT) は、Gemini CLI からConnect AI への接続を認証するために使用します。アクセスの粒度を維持するために、サービスごとに個別の PAT を作成することをおすすめします。

  1. Connect AI アプリの右上にある歯車アイコン () をクリックして、設定ページを開きます。
  2. 「Settings」ページで、「Access Tokens」セクションに移動し、 「Create PAT」をクリックします。
  3. PAT に名前を付けて「Create」をクリックします。
  4. パーソナルアクセストークンは作成時にのみ表示されます。必ずコピーして、今後の使用のために安全に保管してください。

これで、Gemini CLI からAlloyDB に接続する準備が整いました！

ステップ 2: CData Connect AI 用に Gemini CLI を構成

それでは、CData Connect AI に接続するための Gemini CLI を構成していきましょう。

  1. システムに Gemini CLI がインストールされていることを確認します。インストールされていない場合は、npm を使用してインストールしましょう。 
    npm install -g @google/gemini-cli
  2. Gemini CLI の設定ファイルを見つけましょう。ファイルが存在しない場合は新規作成してください。
    • Linux/Unix/Mac: ~/.gemini/settings.json
    • Windows: %USERPROFILE%\.gemini\settings.json
  3. 設定ファイルの「mcpServers」オブジェクトに CData Connect AI を追加します。YOUR_EMAIL とYOUR_PAT を、Connect AI のメールアドレスと先ほど作成したPAT に置き換えてください。 
    {
  "mcpServers": {
    "cdata-connect-cloud": {
      "httpUrl": "https://mcp.cloud.cdata.com/mcp",
      "headers": {
        "Authorization": "Basic YOUR_EMAIL:YOUR_PAT"
      }
    }
  }
}
    例えば、メールアドレスが [email protected] で、PAT が Uu90pt5vEO... の場合、Authorization ヘッダーは次のようになります: 
    "Authorization": "Basic [email protected]:Uu90pt5vEO..."
  4. 設定ファイルを保存します。これで、Gemini CLI はデータ操作に CData Connect AI MCP Server を使用するようになります。

ステップ 3: 自然言語でライブの AlloyDB のデータ をクエリする

Gemini CLI が構成され、CData Connect AI に接続されたので、自然言語クエリを使用して AlloyDB と対話できるようになりました。MCP 統合により、質問をして AlloyDB データソースからリアルタイムで応答を受け取ることができます。

Gemini CLI を使ってデータの探索を始めてみましょう:

  1. ターミナルを開いて、Gemini CLI セッションを開始します: 
    gemini
  2. これで、自然言語を使って AlloyDB をクエリできます。例えば:
    • 「過去 30 日間のすべての顧客を表示して」
    • 「最もパフォーマンスの良い製品は何ですか?」
    • 「第 4 四半期の売上トレンドを分析して」
    • 「すべてのアクティブなプロジェクトとその現在のステータスをリスト表示して」
  3. Gemini CLI は、自然言語クエリを適切な SQL クエリに自動的に変換し、CData Connect AI MCP Server を通じて AlloyDB データに対して実行します。

Gemini CLI の自然言語処理機能と CData Connect AI の堅牢なデータ接続機能を組み合わせることで、複雑な SQL クエリを記述したり、基礎となるデータ構造の深い技術知識を必要とすることなく、AlloyDB を探索して分析できます。

CData Connect AI を入手する

クラウドアプリケーションから 300 以上の SaaS、ビッグデータ、NoSQL ソースへのライブデータアクセスを取得するには、今すぐ CData Connect AI をお試しください!

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル お問い合わせ

この記事の内容

関連記事