使用 MCP Toolbox 将 IDE 连接到 Firestore

本页面介绍了如何使用 MCP Toolbox for Databases 将 Firestore 实例连接到支持 Model Context Protocol (MCP) 的集成开发环境 (IDE) 和开发者工具。您可以使用这些工具执行查询并与数据库互动。本指南适用于使用现有 IDE 和开发者工具来处理 Firestore 的开发者。

Model Context Protocol (MCP) 是一种开放协议，用于将大语言模型 (LLM) 连接到 Firestore 等数据源。本页介绍如何使用 MCP Toolbox for Databases 通过以下 IDE 将开发者辅助工具公开给 Firestore 实例：

设置 Firestore

  1. 创建新的 Google Cloud 项目或选择现有项目。

  2. 为您的项目启用 Firestore API。

  3. 创建 Firestore 数据库（如果您尚未创建）。

  4. 为本地环境设置身份验证。

安装 MCP Toolbox

  1. 以二进制文件形式下载最新版本的 MCP Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 MCP Toolbox V0.13.0 版或更高版本。

    linux/amd64

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

    将 version 替换为 MCP Toolbox 版本号，例如 v0.13.0。

    darwin/arm64

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

    将 version 替换为 MCP Toolbox 版本号，例如 v0.13.0。

    darwin/amd64

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

    将 version 替换为 MCP Toolbox 版本号，例如 v0.13.0。

    windows/amd64

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

    将 version 替换为 MCP Toolbox 版本号，例如 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，然后前往设置。
  2. 在开发者标签页中，点击修改配置以打开配置文件。
  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 服务器图标。
  2. 点击配置 MCP 服务器以打开配置文件。
  3. 添加以下配置，将环境变量替换为您的值，然后保存。

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

服务器成功连接后，系统会显示绿色的活跃状态。

光标

  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，然后依次前往设置 > Cursor 设置 > 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 图标，然后点击配置以打开配置文件。
  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 安全规则语法和错误。