在 Windsurf、Cline、Claude Desktop 等 Agent 中安装 Firebase Agent Skills 与 MCP 服务器:通用配置指南 📅 发布时间:2026/9/13 22:20:32 👁 浏览次数: 在 Windsurf、Cline、Claude Desktop 等 Agent 中安装 Firebase Agent Skills 与 MCP 服务器通用配置指南【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills导读本文以firebase-basics技能包中的 Other Agents Setup 为核心讲解如何为未被官方单独覆盖的第三方 AI 编程 Agent如 Windsurf、Cline、Claude Desktop 等安装 Firebase Agent Skills 与 Firebase MCP 服务器。读完本文你将掌握npx skills的安装与校验流程、MCP 配置文件的合并与验证方法以及如何在重启 Agent 后确认 Firebase MCP 连接生效从而让任意 Agent 直接操作 Firebase 项目。适用场景与前置条件在firebase-basics技能体系中SKILL.md 专门针对 Gemini CLI、Antigravity、Android Studio、Claude Code、Cursor、GitHub Copilot 等环境给出了定制化安装指引而Other Agents指代上述之外、同样遵循 Agent Skills 与 MCPModel Context Protocol规范的第三方 Agent。它们所需的安装物只有两样Firebase Agent Skills一组以firebase-basics为代表的、描述 Firebase 操作流程的技能文件Firebase MCP Server由firebase-tools提供的mcp命令启动让 Agent 能直接读写 Firebase 项目。正式安装前应确保本地环境满足 local-env-setup.md 列出的三条基线Node.js 20运行node --version校验过低版本建议使用 nvm / nvm-windows 安装 Node 24Firebase CLI 可用运行npx -y firebase-toolslatest --version能输出版本号即可已完成登录运行npx -y firebase-toolslatest login无浏览器环境改用login --no-localhost。推荐采用全局安装为保证多个项目间体验一致官方推荐将 Agent Skills 与 MCP 服务器安装为全局配置。这样切换项目时无需重复安装Agent 也能在所有工作区中稳定发现 Firebase 能力。步骤 1安装并验证 Firebase Skills在动手安装前先做检查避免重复安装或破坏既有环境。1.1 检查本地安装运行npx skills list --agent agent-name将agent-name替换为你的实际 Agent 名称例如windsurf、cline、claude-desktop。若输出中包含firebase-basics说明技能已安装在本地可跳过后续安装。1.2 检查全局安装若本地未找到再检查全局安装npx skills list --global --agent agent-name输出包含firebase-basics即代表已全局安装。1.3 安装 Firebase Agent Skills若上述两项检查均未命中执行npx skills add firebase/agent-skills --agent agent-name --skill *firebase/agent-skills是技能发布源--skill *表示安装全部 Firebase 技能firebase-basics即其中一员不追加--yes与--global时CLI 会交互式询问安装位置若在自动化终端中收到交互提示需要通过标准输入传入相应选项以完成安装。1.4 复核安装结果重新执行 1.1 或 1.2 的检查命令确认firebase-basics已出现在输出列表中。说明这一「先查本地、再查全局、最后安装、最后复核」的四段式流程与本技能包中 Cursor 配置、GitHub Copilot 配置 等文档保持一致属于 Firebase 官方推荐的幂等安装范式。步骤 2配置并验证 Firebase MCP 服务器MCP 服务器是 Agent 与 Firebase 项目交互的桥梁让 Agent 可以调用 Firebase 提供的工具如读取 Crashlytics 日志、执行 Data Connect 查询等。2.1 定位 MCP 配置文件不同 Agent 的配置文件路径不同常见位置包括Windsurf~/.codeium/windsurf/mcp_config.jsonClinecline_mcp_settings.jsonClaude Desktopclaude_desktop_config.json如果文档或所在目录不存在请先创建目录并初始化文件内容为{ mcpServers: {} }2.2 检查已有配置打开配置文件在mcpServers对象中查找firebase条目。判定「已正确配置」的标准是command为firebase或command为npx且args中同时包含firebase-tools与mcp。重要只要找到合法的firebase条目MCP 服务器就已配置完成请跳过步骤 2.3直接进入步骤 2.4。以下两种都是合法配置示例firebase: { command: npx, args: [-y, firebase-toolslatest, mcp] }或firebase: { command: firebase, args: [mcp] }2.3 新增或修正配置若firebase块缺失或配置不正确将其加入mcpServers对象firebase: { command: npx, args: [ -y, firebase-toolslatest, mcp ] }关键必须将这段配置合并进现有文件mcpServers对象中已有的其他服务器条目要原样保留不得覆盖或删除。2.4 校验配置保存文件后确认firebase块存在且整体为合法的 JSON。可以在终端中对配置做一次快速解析校验例如node -e JSON.parse(require(fs).readFileSync(mcp配置路径, utf8)); console.log(JSON OK)步骤 3重启 Agent 并确认连接重启 Agent引导用户重启 Agent 应用必须停下等待用户确认完成后再继续否则新配置不会加载。确认连接在 Agent 界面的 MCP 服务器列表中查看确认 Firebase MCP 服务器已显示为「已连接」。从源码结构看这一「配置—重启—确认」的收尾环节在 SKILL.md 及各环境专属文档中被反复强调无论是 Gemini CLI 的gemini mcp list、Claude Code 的claude mcp list还是 Cursor 的 MCP 列表最终都以「重启后确认连接」作为安装成功的唯一判据。验证要点与后续使用安装完成后建议结合 SKILL.md 中的使用原则做一次端到端验证CLI 一律走 npx所有 Firebase CLI 操作统一使用npx -y firebase-toolslatest前缀如npx -y firebase-toolslatest --version确保始终使用最新版本不要回退到裸firebase命令远程 API 走 MCP需要调用 Firebase 远程 API获取 Crashlytics 日志、执行 Data Connect 查询等时优先使用 Firebase MCP Server 提供的工具而不是手工拼 HTTP 请求知识优先官方检索涉及 Firebase 相关知识时优先使用developerknowledge_search_documents等官方 MCP 工具检索搜索词中包含 Firebase 可显著提升命中率保持技能更新Firebase 最佳实践演进较快需定期检查并更新插件或 Agent Skills通用环境下的刷新流程可参考 refresh/other-agents.md。若登录或连接异常可先检查本机 CLI 登录状态npx -y firebase-toolslatest login无浏览器环境请改用--no-localhost方式完成认证后再重启 Agent。与主流 Agent 环境的安装差异对照other_agents.md描述的通用流程与仓库内各专属文档本质上是同一套「Skills MCP」双组件安装逻辑差异主要在命令入口与配置载体Agent 环境安装入口配置文件/命令对应文档Cursornpx skills add ... --agent cursor~/.cursor/mcp.json或.cursor/mcp.jsonsetup/cursor.mdGitHub Copilotnpx skills add ... --agent github-copilot.vscode/mcp.json或用户设置mcp.jsonsetup/github_copilot.mdClaude Codeclaude plugin marketplace addclaude plugin installclaude mcp list -s user/projectsetup/claude_code.mdGemini CLIgemini extensions installgemini mcp add -e IS_GEMINI_CLI_EXTENSIONtrue ...setup/gemini_cli.md其他 AgentWindsurf / Cline / Claude Desktopnpx skills add firebase/agent-skills --agent name --skill *mcp_config.json/cline_mcp_settings.json/claude_desktop_config.json本文setup/other_agents.md可以看到专用文档为每个环境做了更精细的路径适配例如 Copilot 使用mcp.servers且需带type: stdio而other_agents.md面向未被逐一覆盖的 Agent采用更通用的mcpServers结构与统一命令是最简可用的兜底方案。小结为 Windsurf、Cline、Claude Desktop 等「其他 Agent」启用 Firebase 能力本质上只做三件事用npx skills装好 Firebase Agent Skills、把 Firebase MCP 服务器合并进对应配置文件、重启并确认连接。本文给出的命令与 JSON 配置均可直接复制使用若你的 Agent 已在本技能包中有专属文档请优先参考 SKILL.md 中列出的对应 setup 文档以获得路径更精确的配置指引。【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考