MCP Server Firebase

🚀 FirebaseベースのModel Context Protocol (MCP) サーバー

これはFirebaseをベースとしたModel Context Protocol (MCP) サーバーの実装で、2種類の実行モードを提供します。

1. ローカルNode.jsモード（Firebase Admin SDKを使用）
2. Cloudflare Workersモード（Firebase REST APIを使用）

🚀 クイックスタート

このサーバーはFirestoreデータベースの操作を容易にするために開発されました。2種類の実行モードを提供し、ローカル環境での開発やCloudflare Workersへのデプロイが可能です。

✨ 主な機能

• Firestoreデータベース操作（ドキュメントの読み取り、書き込み、更新、削除）
• コレクションとサブコレクションの一覧照会
• フィルタ条件をサポートする照会

📦 インストール

1. このプロジェクトをクローンします。

git clone https://github.com/[あなたのユーザー名]/mcp-server-firebase.git
cd mcp-server-firebase

2. 依存関係をインストールします。

npm install

📚 ドキュメント

必要条件

• Node.js 18以上
• Firebaseプロジェクト
• ローカルモード用のFirebaseサービスアカウント
• Cloudflare Workersモード用のFirebase Web APIキー

設定

ローカルモード設定（Firebase Admin SDK）

1. Firebaseコンソールからサービスアカウントのキーファイルをダウンロードします。
   • Firebaseコンソール > プロジェクト設定 > サービスアカウント > 新しい秘密鍵を生成
2. ダウンロードしたJSONファイルをプロジェクトディレクトリに保存します（ファイル名は重要ではありませんが、パスを覚えておいてください）。
3. 環境変数を設定します。

export SERVICE_ACCOUNT_KEY_PATH="/path/to/your-service-account.json"

Cloudflare Workersモード設定

1. wrangler.tomlファイルの環境変数を更新します。
   • FIREBASE_PROJECT_ID: あなたのFirebaseプロジェクトID
   • FIREBASE_API_KEY: あなたのFirebase Web APIキー
   • FIREBASE_AUTH_DOMAIN: 通常は[PROJECT_ID].firebaseapp.com
2. または、Cloudflare Secretsを使用して環境変数を設定します。

npx wrangler secret put FIREBASE_PROJECT_ID
npx wrangler secret put FIREBASE_API_KEY
npx wrangler secret put FIREBASE_AUTH_DOMAIN

実行

ローカルモード（Firebase Admin SDK）

# TypeScriptをコンパイルしてサーバーを起動
npm run dev

または、提供されているスクリプトを使用して環境変数を設定して起動します。

# 対話式に環境変数を設定してサーバーを起動
node src/index.ts

Cloudflare Workersモード

cd workers
npm install && npm run dev

使用方法

プロジェクトの初期化

ルートディレクトリで以下のコマンドを実行します。

npm install mcp-server-firebase

サーバーの起動（ローカルモード）

npm start

Cloudflare Pagesへのデプロイ

1. wrangler.tomlで環境変数を設定します。
2. 以下のコマンドを実行します。

npm run build && npm run deploy

安全上の注意事項

⚠️ 重要提示

• サービスアカウントキーやAPIキーをGitリポジトリにコミットしないでください。
• デプロイ前にすべての機密情報を環境変数またはSecretsとして設定してください。
• Firestoreに適切なセキュリティルールを設定してください。

注意事項

💡 使用建议

• src/worker.tsはCloudflare Workers用のデプロイバージョンです。
• src/index.tsはローカルで実行するバージョンです。
• Firebaseサービスアカウントに適切な権限があることを確認してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。