Firebase MCP

Name: Firebase MCP
Author: gannonh

プロジェクトロゴ

Firebase テスト CI

概要

Firebase MCP を使用すると、AI アシスタントが次のような Firebase サービスと直接連携できるようになります。

Firestore : ドキュメントデータベース操作
ストレージ: 強力なアップロード機能を備えたファイル管理
認証: ユーザー管理と検証

サーバーは、 Claude Desktop 、 Augment Code 、 VS Code 、 Cursorなどの MCP クライアントアプリケーションで動作します。

⚠️既知の問題： firestore_list_collectionsツールは、クライアントログに Zod 検証エラーを返す場合があります。これは MCP SDK の誤った検証エラーであり、調査の結果、レスポンスにブール値が含まれていないことが確認されました。エラーメッセージが表示されても、クエリは正常に動作し、適切なコレクションデータを返します。これはログレベルのエラーであり、機能には影響しません。

Related MCP server: Firebase App Distribution API MCP Server

⚡ クイックスタート

前提条件

サービスアカウントの認証情報を持つ Firebase プロジェクト
Node.js環境

1. MCPサーバーをインストールする

MCP 設定ファイルにサーバー構成を追加します。

Claude デスクトップ: ~/Library/Application Support/Claude/claude_desktop_config.json
拡張: ~/Library/Application Support/Code/User/settings.json
カーソル: [project root]/.cursor/mcp.json

MCPサーバーは手動でインストールすることも、npx経由で実行時にインストールすることもできます（推奨）。インストール方法によって構成が異なります。

npx 用に設定する（推奨）

{ "firebase-mcp": { "command": "npx", "args": [ "-y", "@gannonh/firebase-mcp" ], "env": { "SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/serviceAccountKey.json", "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app" } } }

ローカルインストール用に設定する

{ "firebase-mcp": { "command": "node", "args": [ "/absolute/path/to/firebase-mcp/dist/index.js" ], "env": { "SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/serviceAccountKey.json", "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app" } } }

2. インストールをテストする

AI クライアントに「すべての Firebase MCP ツールをテストしてください」と依頼します。

🛠️ セットアップと構成

1. Firebaseの設定

Firebaseコンソール→プロジェクト設定→サービスアカウントに移動します
「新しい秘密鍵を生成」をクリックします
JSONファイルを安全に保存する

2. 環境変数

必須

SERVICE_ACCOUNT_KEY_PATH : Firebase サービスアカウントキー JSON へのパス (必須)

オプション

FIREBASE_STORAGE_BUCKET : Firebase Storage のバケット名（デフォルトは[projectId].appspot.com ）
MCP_TRANSPORT : 使用するトランスポートタイプ（ stdioまたはhttp ）（デフォルトはstdio ）
MCP_HTTP_PORT : HTTPトランスポートのポート（デフォルトは3000 ）
MCP_HTTP_HOST : HTTPトランスポートのホスト（デフォルトはlocalhost ）
MCP_HTTP_PATH : HTTPトランスポートのパス（デフォルトは/mcp ）
DEBUG_LOG_FILE : ファイルログを有効にする:
- trueに設定すると、 ~/.firebase-mcp/debug.logにログが記録されます。
- カスタムの場所にログを記録するファイルパスを設定します

3. クライアント統合

クロードデスクトップ

編集: ~/Library/Application Support/Claude/claude_desktop_config.json

VSコード / 拡張

編集: ~/Library/Application Support/Code/User/settings.json

カーソル

編集: [project root]/.cursor/mcp.json

📚 APIリファレンス

Firestore ツール

道具	説明	必須パラメータ
`firestore_add_document`	コレクションにドキュメントを追加する	`collection` 、 `data`
`firestore_list_documents`	フィルタリングしたドキュメントの一覧	`collection`
`firestore_get_document`	特定の文書を取得する	`collection` 、 `id`
`firestore_update_document`	既存のドキュメントを更新する	`collection` 、 `id` 、 `data`
`firestore_delete_document`	ドキュメントを削除する	`collection` 、 `id`
`firestore_list_collections`	ルートコレクションの一覧	なし
`firestore_query_collection_group`	サブコレクション間のクエリ	`collectionId`

ストレージツール

道具	説明	必須パラメータ
`storage_list_files`	ディレクトリ内のファイルを一覧表示する	なし（オプション： `directoryPath` ）
`storage_get_file_info`	ファイルのメタデータとURLを取得する	`filePath`
`storage_upload`	コンテンツからファイルをアップロード	`filePath` 、 `content`
`storage_upload_from_url`	URLからファイルをアップロード	`filePath` 、 `url`

認証ツール

道具	説明	必須パラメータ
`auth_get_user`	IDまたはメールでユーザーを取得する	`identifier`

💻 開発者ガイド

設置と構築

git clone https://github.com/gannonh/firebase-mcp cd firebase-mcp npm install npm run build

テストの実行

まず、Firebase エミュレータをインストールして起動します。

npm install -g firebase-tools firebase init emulators firebase emulators:start

次にテストを実行します。

# Run tests with emulator npm run test:emulator # Run tests with coverage npm run test:coverage:emulator

プロジェクト構造

src/ ├── index.ts # Server entry point ├── utils/ # Utility functions └── lib/ └── firebase/ # Firebase service clients ├── authClient.ts # Authentication operations ├── firebaseConfig.ts # Firebase configuration ├── firestoreClient.ts # Firestore operations └── storageClient.ts # Storage operations

🌐 HTTP トランスポート

Firebase MCPは、デフォルトのstdioトランスポートに加えて、HTTPトランスポートをサポートするようになりました。これにより、サーバーを複数のクライアントからアクセスできるスタンドアロンのHTTPサービスとして実行できるようになります。

HTTPトランスポートで実行

HTTP トランスポートを使用してサーバーを実行するには:

# Using environment variables MCP_TRANSPORT=http MCP_HTTP_PORT=3000 node dist/index.js # Or with npx MCP_TRANSPORT=http MCP_HTTP_PORT=3000 npx @gannonh/firebase-mcp

HTTPクライアント構成

HTTP トランスポートを使用する場合は、MCP クライアントを HTTP エンドポイントに接続するように構成します。

{ "firebase-mcp": { "url": "http://localhost:3000/mcp" } }

セッション管理

HTTPトランスポートはセッション管理をサポートしており、複数のクライアントが同じサーバーインスタンスに接続できます。各クライアントは、リクエスト間の状態を維持するために使用される一意のセッションIDを受け取ります。

🔍 トラブルシューティング

よくある問題

ストレージバケットが見つかりません

「指定されたバケットが存在しません」というエラーが表示された場合:

Firebaseコンソール→ストレージでバケット名を確認します
FIREBASE_STORAGE_BUCKET環境変数に正しいバケット名を設定します

Firebaseの初期化に失敗しました

「Firebase が初期化されていません」というエラーが表示される場合:

サービスアカウントキーのパスが正しく絶対であることを確認してください
サービスアカウントに Firebase サービスに対する適切な権限があることを確認する

複合インデックスが必要です

「このクエリには複合インデックスが必要です」というエラーが表示された場合:

エラーメッセージに記載されているURLを探します
リンクに従って、Firebase コンソールで必要なインデックスを作成します。
インデックスが作成された後にクエリを再試行してください（数分かかる場合があります）

`firestore_list_collections`での Zod 検証エラー

firestore_list_collectionsツールの使用時に、「Expected object, received boolean」というメッセージを含む Zod 検証エラーが表示される場合:

⚠️既知の問題： firestore_list_collectionsツールは、クライアントログに Zod 検証エラーを返す場合があります。これは MCP SDK の誤った検証エラーであり、調査の結果、レスポンスにブール値が含まれていないことが確認されました。エラーメッセージが表示されても、クエリは正常に動作し、適切なコレクションデータを返します。これはログレベルのエラーであり、機能には影響しません。

デバッグ

ファイルログを有効にする

問題の診断を支援するために、ファイルログを有効にすることができます。

# Log to default location (~/.firebase-mcp/debug.log) DEBUG_LOG_FILE=true npx @gannonh/firebase-mcp # Log to a custom location DEBUG_LOG_FILE=/path/to/custom/debug.log npx @gannonh/firebase-mcp

MCP クライアント構成でログ記録を有効にすることもできます。

{ "firebase-mcp": { "command": "npx", "args": ["-y", "@gannonh/firebase-mcp"], "env": { "SERVICE_ACCOUNT_KEY_PATH": "/path/to/serviceAccountKey.json", "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app", "DEBUG_LOG_FILE": "true" } } }

リアルタイムログ表示

ログをリアルタイムで表示するには:

# Using tail to follow the log file tail -f ~/.firebase-mcp/debug.log # Using a split terminal to capture stderr npm start 2>&1 | tee logs.txt

MCPインスペクターの使用

MCP インスペクタは対話型のデバッグを提供します。

# Install MCP Inspector npm install -g @mcp/inspector # Connect to your MCP server mcp-inspector --connect stdio --command "node ./dist/index.js"

📋 レスポンスのフォーマット

ストレージアップロードレスポンスの例

{ "name": "reports/quarterly.pdf", "size": "1024000", "contentType": "application/pdf", "updated": "2025-04-11T15:37:10.290Z", "downloadUrl": "https://storage.googleapis.com/bucket/reports/quarterly.pdf?alt=media", "bucket": "your-project.appspot.com" }

ユーザーには次のように表示されます:

## File Successfully Uploaded! 📁 Your file has been uploaded to Firebase Storage: **File Details:** - **Name:** reports/quarterly.pdf - **Size:** 1024000 bytes - **Type:** application/pdf - **Last Updated:** April 11, 2025 at 15:37:10 UTC **[Click here to download your file](https://storage.googleapis.com/bucket/reports/quarterly.pdf?alt=media)**

🤝 貢献する

リポジトリをフォークする
機能ブランチを作成する
テストを使用して変更を実装する（80%以上のカバレッジが必要）
プルリクエストを送信する

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照