文档索引服务

Firebase文档MCP服务器设置

目录布局

docs mcp

这对应于Firebaes文档的索引器。这是一个Go项目 对所列文件路径中包含的Firebase文档进行索引。

docs-mcp服务器

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

genkit mcp测试仪

这是使用docs-MCP服务器进行测试的MCP客户端的genkit实现。

如何使用

从索引开始

1. 设置API密钥。我们正在为文档使用Gemini嵌入模型，因此 从获取API密钥 AI工作室 是必需的。向 设置API密钥，调用 export genaikey="APIKEY" 在您的终端

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

3. 从 docs-mcp 文件夹，呼叫 go run . 这将启动索引 处理中第291行附近列出的文件 main.go 文件。

测试索引器

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

使用Genkit进行测试

1. 通过在中更改此行来设置代码中的API键 嵌入.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。项目构建完成后，您可以通过以下方式测试项目 召唤 npx genkit start -- npx tsx --watch src/index.ts. 这将启动Genkit DevUI，您可以在其中与流程和工具进行交互 直接。通常打开DevUI http://localhost:4000 并访问工具-> find-firebase-doc/find-firebase-doc 工具和制作 请点击此处。您可以看到，请求正在返回我们看到的结果 在模型上下文协议/检查器中。