Firestore MCP

🚀 Firestore MCP サーバー

このサーバーは、Google Firestore と直接やり取りする MCP（モデルコンテキストプロトコル）サーバーです。Claude Desktop を通じて、Firestore ドキュメントの作成、読み取り、更新、削除を行うためのシンプルなインターフェースを提供します。

✨ 主な機能

• Firestore コレクション内にドキュメントを作成する
• Firestore コレクションからドキュメントを読み取る
• 既存のドキュメントを更新する
• ドキュメントを削除する
• フィルタリング、ソート、制限を使用してドキュメントをクエリする
• 利用可能なコレクションを一覧表示する

📦 インストール

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

npm install

2. プロジェクトのビルド

npm run build

3. Claude Desktop の設定

claude_desktop_config.json に以下の内容を追加します。

"firestore-mcp": {
  "command": "node",
  "args": [
    "/path/to/firestore-mcp/build/index.js"
  ],
  "env": {
    "GOOGLE_CLOUD_PROJECTS": "project-id"
  }
}

args 内のパスを実際の index.js のパスに置き換えてください。

GOOGLE_CLOUD_PROJECTS では、プロジェクト ID のカンマ区切りリストを定義します。 例：google-project-id1,google-project-id2 最初にリストされたプロジェクトがデフォルトのプロジェクトになります。

このアプリケーションは、keys フォルダ内に各プロジェクトの .json 認証情報ファイルを見つけることを期待しています。 例：keys/google-project-id1.json、keys/google-project-id2.json クラウドサービスアカウントが Cloud Datastore Owner など、Cloud Firestore とやり取りするための適切な権限を持っていることを確認してください。

💻 利用可能なツール

• getDocument：ID を指定してコレクション内のドキュメントを取得する
• createDocument：コレクション内に新しいドキュメントを作成する
• updateDocument：既存のドキュメントを更新する
• deleteDocument：ドキュメントを削除する
• queryDocuments：フィルタリング、ソート、制限を使用してドキュメントをクエリする
• listCollections：すべての利用可能なコレクションを一覧表示する

💻 使用例

基本的な使用法

以下は、Claude Desktop で各ツールを使用する例です。

ドキュメントの取得

「users」コレクション内の ID が「user123」のドキュメントを取得する

ドキュメントの作成

「users」コレクション内に、以下のデータを含む新しいドキュメントを作成する
{
  "name": "John Doe",
  "email": "john@example.com",
  "age": 30
}

ドキュメントの更新

「users」コレクション内の ID が「user123」のドキュメントの年齢を 31 に変更する

ドキュメントの削除

「users」コレクション内の ID が「user123」のドキュメントを削除する

ドキュメントのクエリ

25 歳を超えるすべてのユーザーを検索し、名前でソートする

コレクションの一覧表示

すべての利用可能な Firestore コレクションを一覧表示する

🔧 開発

• デバッグモード：npm run dev