Firestore MCP Server

Firestore MCP サーバー

Google Firestore と直接やり取りするための MCP（Model Context Protocol）サーバーです。このサーバーは、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 リストの最初のプロジェクトがデフォルトになります。

   アプリケーションは、各プロジェクトの .json 認証情報ファイルが keys フォルダー内にあることを想定しています。 例：keys/google-project-id1.json、keys/google-project-id2.json Cloud Firestore を操作するために必要な適切な権限（Cloud Datastore Owner またはそれより少ない権限）がクラウドサービスアカウントに付与されていることを確認してください。

利用可能なツール

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

Claude Desktop での使用例

Claude Desktop で各ツールを使用する方法の例を以下に示します。

ドキュメントを取得

Get the document with ID "user123" from the "users" collection

ドキュメントを作成

Create a new document in the "users" collection with the following data:
{
  "name": "John Doe",
  "email": "[email protected]",
  "age": 30
}

ドキュメントを更新

Update the document with ID "user123" in the "users" collection to change the age to 31

ドキュメントを削除

Delete the document with ID "user123" from the "users" collection

ドキュメントをクエリ

Find all users over 25 years old, ordered by name

コレクションを一覧表示

List all available Firestore collections

開発

• 監視モード：npm run dev