🔥 UnimindAI后端-Firebase+MCP
用于Unimindai应用程序的带有MCP服务器的Firebase后端。
🏗️ 建筑
- Firebase函数 -API无服务器
- Firestore -数据库NoSQL
- Firebase身份验证 -身份验证JWT
- MCP协议 -JSON-RPC 2.0输出
📦 安装
# 1. Installer Firebase CLI
npm install -g firebase-tools
# 2. Login Firebase
firebase login
# 3. Installer dépendances
cd functions
npm install
# 4. Configurer le projet
firebase use fallalertapp-9b1fa⚙️ 配置
环境变量
# Configurer Replicate API
firebase functions:config:set replicate.api_token="VOTRE_CLE_ICI"
# Voir la configuration
firebase functions:config:get.env文件(仅限本地)
创造 functions/.env:
REPLICATE_API_TOKEN=votre_cle_replicate🚀 部署
# Déployer les functions
firebase deploy --only functions
# Déployer Firestore rules
firebase deploy --only firestore:rules
# Déployer tout
firebase deploy📡 API终点
基本URL
https://us-central1-fallalertapp-9b1fa.cloudfunctions.net/api可用端点
1.聊天
POST /api/chat/send-message
Headers: Authorization: Bearer {firebase_token}
Body: {
"message": "Bonjour",
"conversation_id": "optional"
}2.MCP工具清单
POST /api/mcp/tools/list
Headers: Authorization: Bearer {firebase_token}
Body: {
"jsonrpc": "2.0",
"method": "tools/list",
"id": 1
}3.MCP工具调用
POST /api/mcp/tools/call
Headers: Authorization: Bearer {firebase_token}
Body: {
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "save_note",
"arguments": {
"title": "Ma note",
"content": "Contenu de la note"
}
},
"id": 1
}4.健康检查
GET /health🛠️ 可用的 MCP 工具
知识库
save_note-保存注释search_notes-搜索笔记list_notes-列出所有注释delete_note-删除注释
个性化(即将推出)
track_action-记录动作get_user_profile-用户配置文件
日历(即将推出)
get_events-活动日历check_availability-检查可用性
电子邮件(即将发布)
search_emails-搜索电子邮件list_emails-Lister电子邮件
🗄️ 消防仓库结构
users/
{userId}/
profile: {...}
subscription: {tier, status, ...}
user_profile: {preferences, ...}
conversations/
{conversationId}/
messages/
{messageId}: {role, content, timestamp}
notes/
{noteId}: {title, content, tags, created_at}
actions/
{actionId}: {type, data, timestamp}🧪 本地测试
# Lancer l'émulateur
cd functions
npm run serve
# URL locale
http://localhost:5001/fallalertapp-9b1fa/us-central1/api🔐 安全
- ✅ 身份验证JWT Firebase
- ✅ Firestore规则(用户隔离)
- ✅ 速率限制
- ✅ CORS 已配置
- ✅ 通过环境变量的秘密
📊 监控
# Voir les logs
firebase functions:log
# Voir les erreurs
firebase functions:log --only api
# Dashboard
# Firebase Console → Functions → Logs🔄 工作流程
- 用户登录→ Firebase身份验证→ JWT令牌
- 应用程序调用API→ 令牌已验证
- API处理请求→ 调用MCP工具
- MCP工具访问Firestore/外部API
- 响应返回到应用程序
📞 支持
对于任何问题:
📄 许可证
MIT许可证
