MCP ツールボックスを使用して IDE を Firestore に接続する

このページでは、データベース向け MCP ツールボックスを使用して、Firestore インスタンスを Model Context Protocol（MCP）をサポートする統合開発環境（IDE）とデベロッパー ツールに接続する方法について説明します。これらのツールを使用して、クエリを実行し、データベースを操作します。このガイドは、既存の IDE とデベロッパー ツールを使用して Firestore を操作するデベロッパーを対象としています。

Model Context Protocol（MCP）は、大規模言語モデル（LLM）を Firestore などのデータソースに接続するためのオープン プロトコルです。このページでは、データベース向け MCP ツールボックスと次の IDE を使用して、デベロッパー支援ツールを Firestore インスタンスに公開する方法について説明します。

Firestore を設定する

  1. Google Cloud プロジェクトを新規作成するか、既存のプロジェクトを選択します。

  2. プロジェクトで Firestore API を有効にします。

  3. まだ作成していない場合は、Firestore データベースを作成します。

  4. ローカル環境の認証を設定します。

MCP ツールボックスをインストールする

  1. MCP ツールボックスの最新バージョンをバイナリとしてダウンロードします。オペレーティング システム（OS）と CPU アーキテクチャに対応するバイナリを選択します。MCP ツールボックス バージョン V0.13.0 以降を使用する必要があります。

    linux/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/linux/amd64/toolbox

    version は、MCP ツールボックスのバージョン番号（v0.13.0 など）に置き換えます。

    darwin/arm64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/arm64/toolbox

    version は、MCP ツールボックスのバージョン番号（v0.13.0 など）に置き換えます。

    darwin/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/darwin/amd64/toolbox

    version は、MCP ツールボックスのバージョン番号（v0.13.0 など）に置き換えます。

    windows/amd64

    curl -O https://storage.googleapis.com/genai-toolbox/version/windows/amd64/toolbox

    version は、MCP ツールボックスのバージョン番号（v0.13.0 など）に置き換えます。

  2. バイナリを実行可能にします。

    chmod +x toolbox

  3. インストールを確認します。

    ./toolbox --version

MCP クライアントを構成する

Claude Code

  1. Claude Code をインストールします。
  2. プロジェクトのルートに .mcp.json ファイルが存在しない場合は作成します。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Claude コードを再起動して、新しい構成を適用します。

Claude Desktop

  1. Claude Desktop を開き、[Settings] に移動します。
  2. [Developer] タブで [Edit Config] をクリックして、構成ファイルを開きます。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Claude Desktop を再起動します。
  2. 新しいチャット画面に、使用可能な新しい MCP サーバーのハンマー（MCP）アイコンが表示されます。

Cline

  1. VS Code で Cline 拡張機能を開き、[MCP Servers] アイコンをタップします。
  2. [Configure MCP Servers] をクリックして構成ファイルを開きます。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。

 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

サーバーが正常に接続されると、緑色のアクティブ ステータスが表示されます。

Cursor

  1. プロジェクトのルートに .cursor ディレクトリが存在しない場合は作成します。
  2. .cursor/mcp.json ファイルが存在しない場合は作成し、開きます。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }
  1. Cursor を開き、[Settings] > [Cursor Settings] > [MCP] に移動します。サーバーが接続されると、緑色のアクティブ ステータスが表示されます。

Visual Studio Code（Copilot）

  1. VS Code を開き、プロジェクトのルートに .vscode ディレクトリが存在しない場合は作成します。
  2. .vscode/mcp.json ファイルが存在しない場合は作成し、開きます。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
 {
    "servers":{
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Windsurf

  1. Windsurf を開き、Cascade アシスタントに移動します。
  2. MCP アイコンをクリックし、[Configure] をクリックして構成ファイルを開きます。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Gemini CLI

  1. Gemini CLI をインストールします。
  2. 作業ディレクトリに .gemini という名前のフォルダを作成します。その中に settings.json ファイルを作成します。
  3. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

Gemini Code Assist

  1. Visual Studio Code に Gemini Code Assist 拡張機能をインストールします。
  2. Gemini Code Assist のチャットでエージェント モードを有効にします。
  3. 作業ディレクトリに .gemini という名前のフォルダを作成します。その中に settings.json ファイルを作成します。
  4. 次の構成を追加し、環境変数を実際の値に置き換えて保存します。
 {
    "mcpServers": {
      "firestore": {
        "command": "./PATH/TO/toolbox",
        "args": ["--prebuilt","firestore","--stdio"],
        "env": {
          "FIRESTORE_PROJECT": "PROJECT_ID",
          "FIRESTORE_DATABASE": "DATABASE_NAME"
        }
      }
    }
  }

ツールを使用する

AI ツールが MCP を使用して Firestore に接続されました。AI アシスタントに、コレクションのリスト表示、ドキュメントの取得、コレクションのクエリ、セキュリティ ルールの管理を依頼してみてください。

次のツールで LLM を使用できます。

  • firestore-add-documents: Firestore コレクション パスにドキュメントを追加します。
  • firestore-get-documents: パスで Firestore から複数のドキュメントを取得します。
  • firestore-list-collections: 指定された親パスの Firestore コレクションを一覧表示します。
  • firestore-delete-documents: Firestore から複数のドキュメントを削除します。
  • firestore-query-collection: フィルタリング、並べ替え、制限オプションを使用してコレクションからドキュメントをクエリします。
  • firestore-get-rules: 現在のプロジェクトのアクティブな Firestore セキュリティ ルールを取得します。
  • firestore-update-document: パスで Firestore の既存のドキュメントを更新します。
  • firestore-validate-rules: Firestore セキュリティ ルールの構文とエラーを検証します。