Firebase 文档 MCP 服务器设置

目录结构

docs-mcp

对应于 Firebase 文档的索引器。这是一个 Go 项目，用于索引包含在列出的文件路径中的 Firebase 文档。

docs-mcp-server

这是模型上下文协议服务器，通过 stdio 传输提供内容。

genkit-mcp-tester

这是 MCP 客户端的 Genkit 实现，用于测试 docs-mcp-server。

如何使用

首先进行索引

1. 设置 API 密钥。我们正在使用 Gemini 嵌入模型来处理文档，因此需要从 AI Studio 获取 API 密钥。 要设置 API 密钥，请在终端中调用 export genaikey="APIKEY"

2. 确保输出目录为空。 我们正在将文件写入您的主目录中名为 .indexResp 的文件夹中。 当 go 从 Firebase 文档站点获取文档时，它会将文件以 markdown 格式写入磁盘，并将它们索引到此目录中的 SQL lite 数据库中。 如果索引失败，它会执行重试策略以将文档重新索引为 markdown 格式。

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

测试索引器

1. 设置 API 密钥。我们正在使用 Gemini 嵌入模型来处理文档，因此需要从 AI Studio 获取 API 密钥。 要设置 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. 单击检查器视图中的“连接”，然后单击“工具”->“列出工具”->“find-firebase-doc”，然后输入您要使用的请求。 注意： 作者在使用内置于 VSCode 的终端运行此步骤时遇到了问题，因此如果您遇到类似问题，请尝试系统终端。

使用 Genkit 进行测试

1. 通过更改 embedding.ts 中的这一行代码来设置代码中的 API 密钥： 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。 构建项目后，您可以通过调用 npx genkit start -- npx tsx --watch src/index.ts 来测试项目。 这将启动 Genkit DevUI，您可以在其中直接与流程和工具进行交互。 打开 DevUI，通常是 http://localhost:4000，然后访问“工具”-> find-firebase-doc/find-firebase-doc 工具并在此处发出请求。 您可以看到该请求随后返回我们在 modelcontextprotocol/inspector 中看到的结果。