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 キーを設定します。ドキュメントの処理には双子星埋め込みモデル（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 を実行してプロジェクトをテストします。これにより、インスペクターが起動し、STDIO サーバーを確認するための URL が表示されます。
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 を実行します。ビルドが完了したら、npm start を実行して Genkit テストを開始します。
5. ターミナルに以下の内容を入力してテストを開始します：

   mcp-tester
   

6. 指示に従って、処理する内容を入力してテストを行います。