Firebase MCP 服务器

您可以使用 Firebase MCP 服务器为 AI 赋能的开发工具提供与 Firebase 项目协同运作的能力。Firebase MCP 服务器可与任何可充当 MCP 客户端的工具配合使用，包括 Claude Desktop、Cline、Cursor、Visual Studio Code Copilot、Windsurf Editor 等。

已配置为使用 Firebase MCP 服务器的编辑器可以使用 AI 功能来帮助您：

• 创建和管理 Firebase 项目
• 管理您的 Firebase Authentication 用户
• 在 Cloud Firestore 和 Firebase Data Connect 中处理数据
• 检索 Firebase Data Connect 架构
• 了解适用于 Firestore 和 Cloud Storage for Firebase 的安全规则
• 使用 Firebase Cloud Messaging 发送消息

这只是部分列表；如需查看编辑器可用的工具的完整列表，请参阅服务器功能部分。

准备工作

1. 确保您已安装正常运行的 Node.js 和 npm。

2. 通过运行以下命令向 Firebase CLI 进行身份验证：

   npx -y firebase-tools@latest login --reauth

   Firebase MCP 服务器使用 CLI 来处理 Firebase 项目的身份验证。您必须先使用 CLI 进行身份验证，然后才能使用 MCP 服务器。如果您尝试未登录就使用服务器，或者身份验证令牌已过期，服务器将输出一条错误消息，提示您重新进行身份验证。

设置 MCP 客户端

Firebase MCP 服务器可以与任何支持标准 I/O (stdio) 作为传输媒介的 MCP 客户端配合使用。以下是一些热门工具的具体说明：

基本配置

Claude Desktop

如需将 Claude Desktop 配置为使用 Firebase MCP 服务器，请修改 claude_desktop_config.json 文件。您可以从 Claude > 设置菜单中打开或创建此文件。选择开发者标签页，然后点击修改配置。

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
    }
  }
}

Cline

如需将 Cline 配置为使用 Firebase MCP 服务器，请修改 cline_mcp_settings.json 文件。您可以通过点击 Cline 窗格顶部的 MCP Servers 图标，然后点击配置 MCP 服务器按钮来打开或创建此文件。

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "experimental:mcp"],
      "disabled": false
    }
  }
}

光标

如需将 Cursor 配置为使用 Firebase MCP 服务器，请修改文件 .cursor/mcp.json（用于仅配置特定项目）或 ~/.cursor/mcp.json（用于使 MCP 服务器在所有项目中可用）：

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
   }
}

Visual Studio Code Copilot

如需配置单个项目，请修改工作区中的 .vscode/mcp.json 文件：

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
  }
}

如需使服务器在您打开的每个项目中可用，请修改用户设置：

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
    }
  }
}

Windsurf 编辑器

如需配置 Windsurf 编辑器，请修改 ~/.codeium/windsurf/mcp_config.json 文件：

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "experimental:mcp"]
  }
}

可选配置

除了前面显示的每个客户端的基本配置之外，您还可以指定两个可选参数：

• --dir ABSOLUTE_DIR_PATH：包含 firebase.json 的目录的绝对路径，用于为 MCP 服务器设置项目上下文。如果未指定，将启用 get_project_directory 和 set_project_directory 工具，默认目录为启动 MCP 服务器时的工作目录。

• --only FEATURE_1,FEATURE_2：要激活的功能组的逗号分隔列表。使用此参数可将显示的工具限制为您正在使用的功能。请注意，核心工具始终可用

例如：

"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest", "experimental:mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

MCP 服务器功能