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 列表中的第一个项目为默认项目。

   应用会在 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 中使用各工具的示例：

获取文档

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