Firestore MCP Server

Firestore MCP Server

Model Context Protocol (MCP) server for Firebase Firestore. This server enables AI assistants like Claude to directly interact with your Firestore database.

Firebase Firestore用のModel Context Protocol (MCP)サーバーです。ClaudeなどのAIアシスタントがFirestoreデータベースと直接やり取りできるようになります。

Features / 機能

• Full CRUD Operations: Create, read, update, and delete documents
• Collection Management: List collections and subcollections
• Query Support: Filter documents with Firestore query operators
• Document Counting: Get document counts without fetching all data
• Type Conversion: Automatic handling of Firestore types (Timestamp, GeoPoint, etc.)

• フルCRUD操作: ドキュメントの作成、読み取り、更新、削除
• コレクション管理: コレクションとサブコレクションの一覧表示
• クエリサポート: Firestoreクエリ演算子によるドキュメントのフィルタリング
• ドキュメントカウント: 全データを取得せずにドキュメント数を取得
• 型変換: Firestoreの型（Timestamp、GeoPointなど）の自動処理

Requirements / 必要条件

• Node.js 18+
• Firebase project with Firestore enabled / Firestoreが有効なFirebaseプロジェクト
• Firebase Admin SDK credentials (service account) / Firebase Admin SDK認証情報（サービスアカウント）

Installation / インストール

1. Clone the repository / リポジトリをクローン

git clone https://github.com/your-username/firestore-mcp.git
cd firestore-mcp

2. Install dependencies / 依存関係をインストール

npm install

3. Configure Firebase credentials / Firebase認証情報を設定

Copy the example environment file: / 環境変数ファイルをコピー:

cp .env.example .env

Edit .env with your Firebase credentials: / .envにFirebase認証情報を設定:

FIREBASE_PROJECT_ID=your-project-id
FIREBASE_CLIENT_EMAIL=firebase-adminsdk-xxxxx@your-project.iam.gserviceaccount.com
FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"

How to get Firebase credentials / Firebase認証情報の取得方法

1. Go to Firebase Console / Firebaseコンソールにアクセス
2. Select your project / プロジェクトを選択
3. Navigate to Project Settings > Service accounts / プロジェクトの設定 > サービスアカウントに移動
4. Click Generate new private key / 新しい秘密鍵を生成をクリック
5. Download the JSON file / JSONファイルをダウンロード
6. Copy values to your .env file: / .envファイルに値をコピー:
   • project_id → FIREBASE_PROJECT_ID
   • client_email → FIREBASE_CLIENT_EMAIL
   • private_key → FIREBASE_PRIVATE_KEY

4. Build the project / プロジェクトをビルド

npm run build

Claude Code Configuration / Claude Code設定

Project-level configuration (recommended) / プロジェクトレベル設定（推奨）

Create .mcp.json in your project root: / プロジェクトルートに.mcp.jsonを作成:

{
  "mcpServers": {
    "firestore": {
      "command": "node",
      "args": ["/path/to/firestore-mcp/dist/index.js"]
    }
  }
}

Note: The server automatically loads .env from its installation directory, so cwd is not required.

注意: サーバーはインストールディレクトリから自動的に.envを読み込むため、cwdは不要です。

With environment variables inline / 環境変数をインラインで指定

If you prefer not to use a .env file: / .envファイルを使用しない場合:

{
  "mcpServers": {
    "firestore": {
      "command": "node",
      "args": ["/path/to/firestore-mcp/dist/index.js"],
      "env": {
        "FIREBASE_PROJECT_ID": "your-project-id",
        "FIREBASE_CLIENT_EMAIL": "your-client-email",
        "FIREBASE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n"
      }
    }
  }
}

After configuration / 設定後

1. Restart Claude Code / Claude Codeを再起動
2. When prompted, approve the MCP server / プロンプトが表示されたらMCPサーバーを承認
3. The Firestore tools will be available in your conversation / Firestoreツールが会話で使用可能になります

Available Tools / 利用可能なツール

Collection Operations / コレクション操作

Document Operations / ドキュメント操作

Query Operations / クエリ操作

Supported Query Operators / サポートされているクエリ演算子

• == - Equal to / 等しい
• != - Not equa