MCP Firebase

🚀 Firebase MCP 服务器

Firebase MCP（Model-Controller-Provider）服务器是一款功能强大的工具，可用于管理 Firebase 应用程序中的数据与逻辑。它借助一系列预定义工具，简化了应用开发流程，同时提升了代码的可维护性与扩展性。

🚀 快速开始

若要使用 Firebase MCP 服务器，需满足以下先决条件：

1. Firebase 账户：需要一个有效的 Firebase 账户，并创建一个新项目。
2. Node.js：安装 Node.js 和 npm（版本 8 或更高）。
3. MCP 服务器依赖项：确保已安装 MCP 服务器所需的依赖项。

✨ 主要特性

数据模型

MCP 服务器支持开发者创建自定义数据模型，涵盖多种数据类型，如字符串、数字、布尔值、日期和数组等。这些模型可用于表示应用中的实体，像用户、产品、订单等。

控制逻辑

MCP 提供了丰富的控制逻辑功能，包括数据验证、业务规则执行和事件处理。开发者可通过定义规则确保数据的完整性与一致性，并利用事件监听器响应特定操作。

数据提供

MCP 服务器集成了 Firebase 的实时数据库和云存储服务，提供高效的数据同步和存储解决方案。它支持大规模数据访问与操作，适用于各种规模的应用程序。

📦 安装指南

安装 MCP 服务器

使用以下命令下载并安装 MCP 服务器：

npm install firebase-mcp-server --save

配置

在项目根目录下创建一个 mcp-config.json 文件，并添加以下内容：

{
  "firebase": {
    "apiKey": "your_api_key",
    " authDomain": "your_auth_domain",
    " projectId": "your_project_id",
    " storageBucket": "your_storage_bucket",
    " messagingSenderId": "your_messaging_sender_id"
  }
}

💻 使用示例

基础用法

创建用户

await createUser(email: "user@example.com", password: "securepassword123");

更新用户信息

await updateUser(
    userId: "user123",
    email: "newemail@example.com",
    displayName: "New Name"
);

验证邮箱

await verifyEmail(
    userId: "user123",
    actionUrl: "https://yourapp.com/verified"
);

忘记密码

await resetPassword(
    email: "user@example.com",
    actionUrl: "https://yourapp.com/reset-complete"
);

📚 详细文档

运行服务器

启动

使用以下命令启动 MCP 服务器：

node index.js

停止

按 Ctrl+C 停止服务器。

调试

日志记录

MCP 服务器提供详细的日志记录功能，帮助开发者调试和优化应用程序。日志信息包括请求、响应和错误详情。

生命周期管理

通过定义生命周期钩子（beforeCreate, afterCreate 等），开发者可以在数据操作前后执行自定义逻辑。

工具测试

使用 MCP 提供的工具测试功能，验证各个功能模块的行为是否符合预期。

响应格式

所有工具返回的响应都采用一致的格式：

成功响应

{
  "success": true,
  "data": { ... }, // 或相关成功数据
  "message": "操作完成"
}

错误响应

{
  "success": false,
  "error": "错误信息"
}

安全注意事项

⚠️ 重要提示

1. 服务账户密钥：绝对不要将 service-account-key.json 提交到版本控制系统，应将其添加到 .gitignore 文件中，并在生产环境中使用环境变量管理密钥。
2. 身份验证：总是验证用户输入，实现适当的错误处理，并遵循 Firebase 的安全最佳实践。

贡献指南

1. 叉取仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

📄 许可证

MCP 服务器遵循 MIT 许可证。请参阅 LICENSE 文件以获取详细信息。

通过以上指南，您可以轻松地使用 Firebase MCP 服务器来构建高效、安全的应用程序。