Firebase实时查询服务

用于实时查询Firebase项目(Firestore和Cloud Function日志)的MCP服务器。

  • by NigelThorne
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 NigelThorne/firebase_live_mcp_server

使用说明

Firebase实时MCP服务器

用于查询实时Firebase项目的MCP服务器-Firestore和Cloud Function日志。

设置

npm install
npm run build

认证

使用应用程序默认凭据。运行:

gcloud auth application-default login

项目检测

服务器从以下位置自动检测Firebase项目 .firebaserc 在当前工作目录中。

用env var重写:

FIREBASE_PROJECT_ID=my-project

使用Claude Desktop

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "firebase-live": {
      "command": "node",
      "args": ["/Users/nigelthorne/code/firebase_live_mcp_server/dist/index.js"],
      "cwd": "/path/to/your/firebase/project",
      "env": {
        "FIREBASE_PROJECT_ID": "optional-override"
      }
    }
  }
}

这 cwd 应该指向一个目录 .firebaserc 用于自动检测。

工具

工具 说明
list_collections 列出顶级Firestore收藏
list_subcollections 列出文档的子集合
list_documents 列出集合中的文档
get_document 按路径获取单个文档
query_collection 使用过滤器、排序、限制进行查询
get_function_logs 使用grep过滤获取云功能日志

get_function_logs选项

  • pattern -用于过滤日志消息的正则表达式
  • severity -最低级别:调试/信息/通知/警告/错误/临界
  • functionName -按函数名称筛选
  • limit -最大条目数(默认值50)
  • hoursAgo -获取最近N小时的日志(默认值1)

必需的权限

您的gcloud帐户需要:

  • roles/datastore.viewer -Firestore读取权限
  • roles/logging.viewer -云日志读取权限