用途
Cloud User Tools 是 Flow Nexus 平台上的用户管理与系统工具集，通过 MCP 服务器 flow-nexus 提供。它面向需要在 Flow Nexus 中管理账户、文件、实时事件和系统状态的开发者，覆盖用户资料管理、存储操作、实时订阅、执行流监控、系统诊断与审计等场景。
主要能力
用户资料管理
- 获取用户资料：
mcp__flow-nexus__user_profile，返回 id、email、full_name、bio、tier、created_at。 - 更新用户资料：
mcp__flow-nexus__user_update_profile，可更新 full_name、bio、github_username、website 等字段。 - 获取用户统计：
mcp__flow-nexus__user_stats，返回 apps_published、credits_earned、challenges_completed。
存储操作
支持四种存储桶：private（仅用户）、public（任何人）、shared（团队）、temp（自动过期）。提供上传文件（storage_upload）、列出文件（storage_list，limit 最大 1000）、获取公开 URL（storage_get_url，可设置过期秒数）、删除文件（storage_delete）等操作。
实时订阅
可订阅表变更事件：realtime_subscribe 支持 INSERT、UPDATE、DELETE、* 事件，并可附加过滤条件（如 status=eq.pending）。还提供列出订阅（realtime_list）和取消订阅（realtime_unsubscribe）。
执行流监控
- 订阅执行流：
execution_stream_subscribe，stream_type 可为 claude-code、claude-flow-swarm、github-integration。 - 查看流状态：
execution_stream_status。 - 列出执行文件：
execution_files_list，可按 created_by（claude-code、claude-flow、git-clone、user）和 file_type 过滤。 - 获取文件内容：
execution_file_get。
Queen Seraphina 咨询
通过 seraphina_chat 向 AI 助手 Queen Seraphina 提问，可获得架构指导、最佳实践建议、复杂决策支持，并可在 enable_tools 为 true 时执行工具。支持传入 conversation_history 维持上下文。
系统工具
- 检查系统健康：
system_health，返回 status 及 api、database、storage 等服务状态。 - 获取审计日志：
audit_log，可按 user_id 过滤，limit 最大 1000。
使用方式
前置条件：Flow Nexus 账户且会话有效、已配置 flow-nexus MCP 服务器、具备存储操作所需权限。
典型调用示例：
// 更新资料
await mcp__flow-nexus__user_update_profile({
user_id: "user_id",
updates: {
full_name: "Developer Name",
bio: "AI Developer",
github_username: "username"
}
});
// 上传文件到存储
await mcp__flow-nexus__storage_upload({
bucket: "private",
path: "projects/config.json",
content: JSON.stringify({ key: "value" }),
content_type: "application/json"
});
// 订阅实时更新
await mcp__flow-nexus__realtime_subscribe({
table: "tasks",
event: "INSERT",
filter: "status=eq.pending"
});
// 咨询 Queen Seraphina
const advice = await mcp__flow-nexus__seraphina_chat({
message: "How should I architect my distributed system?",
enable_tools: true
});
适用场景
- 管理用户资料和账户设置
- 在云存储中上传和组织文件
- 设置实时通知和订阅
- 监控系统健康和诊断
- 咨询 Queen Seraphina 获取指导
- 跟踪执行流和输出文件
- 查看审计日志以保障安全
限制与注意事项
- 需要 Flow Nexus 账户、有效会话、已配置的
flow-nexusMCP 服务器及相应存储权限。 - 存储列表 limit 最大 1000，审计日志 limit 最大 1000。
- 常见错误包括 profile_not_found、storage_upload_failed、subscription_failed、seraphina_unavailable、file_not_found，需按提示检查参数或稍后重试。
- 建议保持资料完整、合理选择存储桶、规范文件目录、及时取消不再需要的订阅、定期查看审计日志。
- 与认证、沙箱等模块存在集成点，例如资料更新需认证，执行流监控可关联沙箱。
- 相关技能包括 cloud-auth、cloud-payments、cloud-sandbox。
- 版本历史：1.0.0（2026-01-02）初始发布，由 flow-nexus-user-tools agent 转换而来。