Django Firebase MCP

🚀 Django Firebase MCP

このDjangoアプリケーションは、Firebase Model Context Protocol (MCP) サーバーを実装しており、AIエージェントが標準化されたプロトコルを通じてFirebaseサービスとやり取りできるようになります。

🚀 クイックスタート

テスト用のスタンドアロンFirebaseエージェントを使って、5分以内に起動して動作を確認できます。

前提条件

• Python 3.11以上
• Admin SDKを持つFirebaseプロジェクト
• Git（オプション）
• Redis（永続的な状態管理に使用する場合、オプション）

1. クローンとセットアップ

git clone https://github.com/your-repo/django-firebase-mcp.git
cd django-firebase-mcp

2. 依存関係のインストール

pip install -r requirements.txt

3. Firebaseのセットアップ

Firebaseの資格情報を取得する

1. Firebaseコンソールにアクセスします。
2. プロジェクトを選択するか（または新しく作成します）。
3. Project Settings → Service Accountsに移動します。
4. "Generate new private key" をクリックします。
5. JSONファイルをダウンロードし、プロジェクトのルートに credentials.json として保存します。

Firebaseサービスを有効にする

Firebaseプロジェクトで以下のサービスが有効になっていることを確認してください。

• Authentication（ユーザー管理用）
• Firestore Database（ドキュメントの保存用）
• Cloud Storage（ファイルアップロード用）

4. 環境設定

プロジェクトのルートに .env ファイルを作成します。

# Firebase Configuration
SERVICE_ACCOUNT_KEY_PATH=credentials.json
FIREBASE_STORAGE_BUCKET=your-project-id.appspot.com

# MCP Configuration
MCP_TRANSPORT=http
MCP_HOST=127.0.0.1
MCP_PORT=8001

# Django Settings
DEBUG=True
SECRET_KEY=your-secret-key-here

⚠️ 重要提示

your-project-id を実際のFirebaseプロジェクトIDに置き換えてください。

5. 状態管理のセットアップ

Firebase MCPエージェントは会話の永続化のために状態管理を使用します。以下のオプションから選択してください。

オプションA: Redis（本番環境で推奨）

Redisをポート6379でインストールして実行します。

# Chocolateyを使用してRedisをインストール
choco install redis-64

# または、https://github.com/microsoftarchive/redis/releases からダウンロード
# その後、Redisサーバーを実行
redis-server

.env ファイルに以下を追加します。

# Redis Configuration
REDIS_URL=redis://localhost:6379
USE_REDIS=true

オプションB: InMemorySaver（クイックテスト用）

Redisを使用せずにクイックテストを行う場合、エージェントは自動的にInMemorySaverを使用します。追加の設定は必要ありません。

.env ファイルに以下を追加します。

# メモリベースの状態（永続化なし）
USE_REDIS=false

⚠️ 重要提示

InMemorySaverは再起動の間で会話を保存しませんが、Redisはセッション間で状態を維持します。

6. スタンドアロンエージェントでのクイックテスト

スタンドアロンFirebaseエージェントを使ってすぐにセットアップをテストします。

# スタンドアロンエージェントを実行
python firebase_admin_mcp/standalone_firebase_agent.py

以下のような表示がされるはずです。

🔥 Firebase MCP Agent Ready!
Type 'help' for available commands, 'quit' to exit.

>

以下のコマンドを試してみてください。

> List all Firebase collections
> Check Firebase health status
> help
> quit

7. 完全なDjangoセットアップ（オプション）

完全なDjango統合を行うには、以下の手順を実行します。

# マイグレーションを適用
python manage.py migrate

# スーパーユーザーを作成（オプション）
python manage.py createsuperuser

# Django開発サーバーを実行
python manage.py runserver 8001

MCPサーバーは http://127.0.0.1:8001/mcp/ で利用できます。

🛠️ 管理コマンド

コアコマンド

# スタンドアロンFirebaseエージェントを実行（クイックテスト用）
python firebase_admin_mcp/standalone_firebase_agent.py

# Djangoを通じてMCPサーバーを実行
python manage.py runserver 8001

# stdioモードでMCPサーバーを実行（MCPクライアント用）
python manage.py run_mcp --transport stdio

# HTTPモードでMCPサーバーを実行
python manage.py run_mcp --transport http --host 127.0.0.1 --port 8001

# Django管理コマンドを通じてスタンドアロンエージェントを実行
python manage.py run_standalone_agent

テストコマンド

# Firebase接続をテスト
python firebase_admin_mcp/tests/test_firebase_connection.py

# MCPサーバーの完全性をテスト
python firebase_admin_mcp/tests/test_mcp_complete.py

# Firebaseエージェントのデモ
python firebase_admin_mcp/tests/demo_firebase_agent.py

# スタンドアロンエージェントのデモ
python firebase_admin_mcp/demo_standalone_agent.py

🔧 利用可能なツール

MCPサーバーは、3つのカテゴリに分けられた 14のFirebaseツール を提供します。

🔐 認証（4つのツール）

• firebase_verify_token - Firebase IDトークンを検証します。
• firebase_create_custom_token - カスタム認証トークンを作成します。
• firebase_get_user - UIDでユーザー情報を取得します。
• firebase_delete_user - ユーザーアカウントを削除します。

📚 Firestoreデータベース（6つのツール）

• firestore_list_collections - すべてのコレクションをリストします。
• firestore_create_document - 新しいドキュメントを作成します。
• firestore_get_document - ドキュメントを取得します。
• firestore_update_document - ドキュメントを更新します。
• firestore_delete_document - ドキュメントを削除します。
• firestore_query_collection - フィルターを使用してクエリを実行します。

🗄️ クラウドストレージ（4つのツール）

• storage_list_files - フィルタリングを使用してファイルをリストします。
• storage_upload_file - ファイルをアップロードします。
• storage_download_file - ファイルをダウンロードします。
• storage_delete_file - ファイルを削除します。

🧪 クイックテスト

サーバーの正常性をテスト

curl http://127.0.0.1:8001/mcp/

Firebaseツールをテスト

curl -X POST http://127.0.0.1:8001/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "firestore_list_collections",
      "arguments": {}
    },
    "id": 1
  }'

🤖 AIエージェントの統合

LangChainの例

from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

# Firebaseツールをインポート
from firebase_admin_mcp.tools.agents.firebase_mcp_client import ALL_FIREBASE_TOOLS

# Firebase機能を持つエージェントを作成
model = ChatOpenAI(model="gpt-4")
agent = create_react_agent(
    model=model,
    tools=ALL_FIREBASE_TOOLS,
    prompt="You are a Firebase assistant with full database and storage access."
)

# エージェントを使用
response = agent.invoke({
    "messages": [{"role": "user", "content": "Show me all my Firestore collections"}]
})

📚 詳細ドキュメント

このプロジェクトには包括的なドキュメントが含まれています。

• FIREBASE_ADMIN_MCP.md - 完全な技術ドキュメント
  • 詳細なAPIリファレンス
  • すべてのツールの仕様
  • 高度な設定
  • セキュリティに関する考慮事項
  • 本番環境へのデプロイガイド
• STANDALONE_AGENT.md - スタンドアロンエージェントのドキュメント
  • 自己完結型のFirebaseエージェント
  • 完全な機能の概要
  • 使用例
  • 統合パターン

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

一般的な問題と解決策

問題: Default app does not exist エラー 解決策: .env ファイル内の credentials.json のパスを確認してください。

問題: サーバーが起動しない 解決策: ポート8001が使用可能か確認します: netstat -an | findstr :8001

問題: Firebase接続に失敗する 解決策: コンソールでFirebaseサービスが有効になっていることを確認してください。

問題: インポートエラー 解決策: すべての依存関係がインストールされていることを確認します: pip install -r requirements.txt

問題: Redis接続に失敗する 解決策: Redisが実行中であることを確認します: redis-cli ping（"PONG"が返るはず）

問題: セッション間で状態が保存されない 解決策: Redisの設定を確認するか、InMemorySaverからRedisに切り替えます。

🎯 次のステップ

1. スタンドアロンエージェントを探索する - クイックテストやデモに最適です。
2. 完全なドキュメントを読む - FIREBASE_ADMIN_MCP.mdを参照して詳細を確認します。
3. AIエージェントと統合する - MCPツールをアプリケーションで使用します。
4. ニーズに合わせてカスタマイズする - 追加のFirebase操作を拡張します。

📝 プロジェクト構造

django-firebase-mcp/
├── README.md                          # このファイル
├── FIREBASE_ADMIN_MCP.md             # 完全なドキュメント
├── STANDALONE_AGENT.md               # スタンドアロンエージェントのガイド
├── requirements.txt                   # Pythonの依存関係
├── credentials.json                   # Firebaseの資格情報（自分で作成）
├── .env                              # 環境変数（自分で作成）
├── manage.py                         # Djangoの管理スクリプト
├── firebase_admin_mcp/               # メインのMCPアプリ
│   ├── standalone_firebase_agent.py  # スタンドアロンエージェント
│   ├── tools/                        # Firebase MCPツール
│   ├── management/commands/          # Djangoのコマンド
│   └── tests/                        # テストスイート
└── django_firebase_mcp/             # Djangoプロジェクトの設定

🤝 コントリビュートの方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をテストします。
4. プルリクエストを送信します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。

🔥 FirebaseでAIエージェントを強化しましょう！

スタンドアロンエージェントから始めて、高度な使用方法については完全なドキュメントを参照してください！