Firebase 文档 MCP 服务器设置指南

目录布局

docs-mcp

该目录对应于 Firebase 文档的索引器。这是一个 Go 项目，用于从指定文件路径中抓取并索引 Firebase 文档。

docs-mcp-server

这是模型上下文协议服务器，通过标准输入输出传输方式提供内容服务。

genkit-mcp-tester

这是一个使用 GenKit 实现的 MCP 客户端，用于测试 docs-mcp-server。

使用方法

开始索引

1. 设置 API 密钥。我们使用双子星嵌入模型（Gemini embedding model）来处理文档，因此需要从 AI 工作室 获取 API 密钥。要设置密钥，请在终端中调用 export genaikey="APIKEY"。

2. 确保输出目录为空。我们会将文件写入用户主目录中的一个名为 .indexResp 的文件夹中。Go 会从 Firebase 文档网站抓取文档并将其以 Markdown 格式保存到磁盘，并在 SQL Lite 数据库中进行索引。如果索引失败，它会执行重试策略，重新将文档索引为 Markdown 格式。

3. 在 docs-mcp 文件夹中调用 go run .，这将启动位于 main.go 文件第 291 行附近列出文件路径的索引过程。

测试索引器

1. 设置 API 密钥。我们使用双子星嵌入模型（Gemini embedding model）来处理文档，因此需要从 AI 工作室 获取 API 密钥。要设置密钥，请在终端中调用 export genaikey="APIKEY"。

2. 切换到 docs-mcp-server 文件夹。

3. 将索引数据库复制到当前 docs-mcp-server 文件夹中。可以通过调用 cp $HOME/.indexResp/db.sqlite . 来完成此操作。

4. 安装依赖项并构建项目。运行 npm ci 然后 npm run build。构建完成后，通过运行 npm run build && npx @modelcontextprotocol/inspector node build/index.js 测试项目。这将启动检查程序，并会打印出一个 URL，供您查看 STDIO 服务器。

5. 在检查程序视图中点击“连接”，然后在工具菜单中选择“List Tools -> find-firebase-doc”。在此处输入您要使用的请求内容进行测试。注意：作者发现使用 VSCode 的终端时会出现类似问题，因此如果遇到类似问题，请尝试使用系统终端。

使用 Genkit 进行测试

1. 在代码中设置 API 密钥，将 docs-mcp-server/src/helpers/embeddings.ts 文件中的以下内容：

   const genAiKey = process.env.genaikey || "";
   

   修改为：

   const genAiKey = process.env.genaikey || "MYAPIKEY";
   

2. 切换到 genkit-mcp-tester 目录。

3. 将索引数据库复制到当前 genkit-mcp-tester 文件夹中。可以通过调用 cp $HOME/.indexResp/db.sqlite . 来完成此操作。

4. 安装依赖项并构建项目。运行 npm ci 然后 npm run build。构建完成后，通过运行命令启动 Genkit 测试：

   npm start
   

5. 在终端中输入以下内容以开始测试：

   mcp-tester
   

6. 根据提示输入要处理的内容进行测试。