Firestore Advanced MCP

🚀 🔥 Firestore 高度なMCP

Firestore高度なMCPは、Firestoreデータベースを操作するための強力なツールです。このツールは、ドキュメントのCRUD操作、自動インデックス、クエリ最適化、およびリアルタイムデータ同期をサポートし、データの一貫性を確保します。

📄 ライセンス

• このプロジェクトはMITライセンスを使用しています。詳細については、LICENSEファイルを参照してください。
• ライセンスとNode.jsの要件：MITライセンスを使用し、Node.jsのバージョンはv14以上が必要です。

✨ 主な機能

• 🔥 ドキュメントの作成、読み取り、更新、削除操作をサポートします。
• 🛡️ 自動インデックスとクエリ最適化機能を提供します。
• 🔄 リアルタイムデータ同期をサポートし、データの一貫性を保証します。

📦 インストール

方法1：npmを通じてインストール

npm install firebase @types/firebase firebase-admin

方法2：ソースコードからインストール

git clone https://github.com/FirebaseExtended/firestore-mcp.git
cd firestore-mcp
npm install

🔧 設定

コンフィグファイルの作成

プロジェクトのルートディレクトリにconfig.jsファイルを作成します。

const firebaseConfig = {
  apiKey: 'your-api-key',
  authDomain: 'your-project-id.firebaseapp.com',
  projectId: 'your-project-id',
  storageBucket: 'your-storage-bucket.appspot.com',
  messagingSenderId: 'your-messaging-sender-id',
  appId: 'your-app-id'
};

initializeApp(firebaseConfig);

環境変数の設定

以下の環境変数を設定してください。

• FIREBASE_API_KEY
• FIREBASE_AUTH_DOMAIN
• FIREBASE_PROJECT_ID
• FIREBASE_STORAGE_BUCKET
• FIREBASE_MESSAGING_SENDER_ID
• FIREBASE_APP_ID

💻 使用例

方法1：npmを通じて実行

node index.js

方法2：npxを通じて実行

npx firebase-mcp

方法3：スクリプトを直接実行

const { initializeApp } = require('firebase-admin/app');
const { getFirestore } = require('firebase-admin/firestore');

const app = initializeApp();
const db = getFirestore(app);

Claudeでの設定

claude-config.jsonファイルに以下を追加します。

{
  "firestore": {
    "apiKey": "your-api-key",
    "authDomain": "your-project-id.firebaseapp.com",
    "projectId": "your-project-id"
  }
}

ツールの機能

1. ドキュメント操作：作成、読み取り、更新、削除。
2. クエリ機能：複数条件のフィルタリング、ソート、およびページングをサポート。
3. データ構造：配列、オブジェクトなどの複雑なデータ型をサポート。
4. バッチ操作：バッチ書き込みと削除。
5. リスナー：データの変更をリアルタイムで監視。

具体的な使用例

ユーザーの取得

{
  "collection": "users",
  "id": "user123"
}

注文の作成

{
  "collection": "orders",
  "data": {
    "product": "Laptop",
    "price": 999.99,
    "fields": [
      {
        "fieldPath": "user",
        "type": "reference",
        "value": "users/user123"
      }
    ]
  }
}

TTLの設定

{
  "collection": "temporaryData",
  "id": "session123",
  "expiresIn": 86400000,
  "fieldName": "expires_at"
}

複数条件のクエリ

{
  "collection": "products",
  "filters": [
    {
      "field": "category",
      "operator": "==",
      "value": "electronics"
    },
    {
      "field": "price",
      "operator": "<",
      "value": 1000
    }
  ],
  "orderBy": {
    "field": "price",
    "direction": "asc"
  },
  "limit": 10
}

📚 ドキュメント

詳細な情報については、以下のドキュメントを参照してください。

• Firestore ドキュメント
• MCP プロトコルドキュメント

👨‍💻 作者

• Diez7lm

🙏 謝辞

• Anthropic がClaudeとMCPプロトコルを提供してくれたことに感謝します。
• Firebase がFirestoreと開発ツールを提供してくれたことに感謝します。

🤝 貢献

このプロジェクトへの貢献を歓迎します！GitHubを通じてプルリクエストや問題を提出して、このプロジェクトを改善してください。