Firebase Docs MCP

🚀 Firebase 文檔 MCP 服務器設置指南

本指南詳細介紹了 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 密鑰：同樣需要從 AI 工作室 獲取 API 密鑰，並在終端中調用 export genaikey="APIKEY" 進行設置。
2. 切換目錄：切換到 docs-mcp-server 文件夾。
3. 複製索引數據庫：通過調用 cp $HOME/.indexResp/db.sqlite . 將索引數據庫複製到當前 docs-mcp-server 文件夾。
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. 複製索引數據庫：通過調用 cp $HOME/.indexResp/db.sqlite . 將索引數據庫複製到當前 genkit-mcp-tester 文件夾。
4. 安裝依賴項並構建項目：運行 npm ci 然後 npm run build。構建完成後，通過運行 npm start 啟動 Genkit 測試。
5. 開始測試：在終端中輸入 mcp-tester。
6. 輸入測試內容：根據提示輸入要處理的內容進行測試。