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