Firestore MCP

🚀 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 Firestore 交互的適當權限，例如 Cloud Datastore Owner 或更少的權限。

📚 詳細文檔

可用工具

• getDocument：通過 ID 獲取集合中的文檔。
• createDocument：在集合中創建新文檔。
• updateDocument：更新現有文檔。
• deleteDocument：刪除文檔。
• queryDocuments：使用過濾、排序和限制查詢文檔。
• listCollections：列出所有可用集合。

💻 使用示例

在 Claude Desktop 中的用法示例

以下是每個工具在 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