Rouse Context MCP 服务说明文档
1. 服务概述一句话简介将Android手机变成MCP服务器让AI助手按需访问手机上的健康数据、通知和应用使用情况无需将数据同步到云端服务名称Rouse Context版本号v1.0开发者/提供方Monkopedia协议类型MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点4个集成模块Health Connect、Notifications、Outreach、Usage Stats22个MCP工具覆盖健康数据查询、通知管理、设备操作、使用统计等功能端到端加密TLS在手机上终止中继仅做SNI透传数据完全加密本地数据处理数据从设备源读取并实时提供不存储在远程OAuth授权每个AI客户端必须通过设备上的批准才能访问工具审计日志每个工具调用都在本地记录包含参数、响应和持续时间按需唤醒手机在客户端连接时唤醒断开后休眠节省电量每设备ACME证书通过Google Trust ServicesDNS-01颁发每设备证书私钥存储在Android Keystore硬件支持3. 使用场景描述该服务适合在什么情况下使用健康数据查询查询Android Health Connect数据涵盖36种记录类型和7个类别活动、身体、睡眠、生命体征、营养、生殖、正念通知管理读取、搜索设备通知执行通知操作关闭通知应用使用统计分析应用使用模式和屏幕时间比较不同时期的使用情况设备操作启动应用、打开链接、发送通知、管理勿扰模式隐私优先场景需要AI访问手机数据但不愿同步到云端的场景4. 接入方式4.1 服务端点Rouse Context通过Android应用提供服务每个集成都有独立的MCP端点URL格式https://{adjective}-{integrationId}.abc123.rousecontext.com/mcp示例https://brave-health.abc123.rousecontext.com/mcp路径始终为/mcp4.2 认证与权限多层安全机制确保数据安全mTLS设备认证中继通过客户端证书认证设备秘密URL前缀每个设备URL包含可轮换的每集成秘密OAuth per-client每个AI客户端必须在设备上批准才能访问工具Android权限应用需要相应的Android权限如通知权限、Health Connect权限等4.3 数据格式服务支持以下数据格式健康数据Health Connect记录格式JSON通知数据通知对象包含包名、标题、内容、操作等使用统计应用使用事件和统计数据4.4 服务器配置在MCP客户端配置中添加服务{ mcpServers: { rouse-health: { url: https://brave-health.abc123.rousecontext.com/mcp } } }5. 接口定义5.1 Health Connect集成3个工具工具名称描述功能list_record_types列出Health Connect记录类型及权限状态查询可用记录类型query_health_data按类型和时间范围查询记录获取健康数据get_health_summary获取指定时期的健康摘要跨权限类型的健康概览5.2 Notifications集成5个工具工具名称描述list_active_notifications列出已发布的通知search_notification_history按文本、包名或时间范围搜索通知历史get_notification_stats获取通知计数、热门应用和最繁忙时段perform_notification_action在活动通知上调用操作按钮dismiss_notification通过key关闭活动通知5.3 Outreach集成10个工具工具名称描述launch_app通过包名启动已安装的应用open_link在默认应用中打开http/https URLcopy_to_clipboard复制文本到剪贴板send_notification发布通知可选操作按钮和点击打开URLlist_installed_apps列出已安装的应用create_notification_channel创建通知渠道list_notification_channels列出AI创建的通知渠道delete_notification_channel删除AI创建的通知渠道get_dnd_state获取勿扰模式状态set_dnd_state设置勿扰模式状态5.4 Usage Stats集成4个工具工具名称描述get_usage_summary获取屏幕时间总计和热门应用get_app_usage获取单个应用的每日使用情况get_usage_events获取原始应用前台/后台事件compare_usage比较两个时期的屏幕时间按最大差异排序6. 快速开始6.1 环境要求Android设备最低SDK版本24Android 7.0目标SDK版本35编译SDK版本36网络连接设备需要网络连接以与中继服务器通信Google Play服务用于FCM推送通知相应权限根据使用的集成需要授予相应权限如通知权限、Health Connect权限等6.2 安装步骤1. 下载APK - 从GitHub Releases下载最新APK - 或发送邮件至betarousecontext.com获取Google Play测试访问权限 2. 安装应用 - 在Android设置中启用安装未知来源应用 - 安装下载的APK 3. 初始化设置 - 打开应用点击Get Started - 授予通知权限 - 应用将注册到中继并配置设备TLS证书约10秒 4. 启用集成 - 在主屏幕点击Add Integration - 选择一个集成如Health Connect - 授予请求的权限 - 获得类似https://brave-health.abc123.rousecontext.com/mcp的URL 5. 连接AI客户端 - 将URL粘贴到ClaudeSettings → Connectors → Add custom connector - 或在Cursor、其他MCP客户端中配置 - 首次连接会在手机上触发OAuth批准点击Approve 6. 开始使用 - 向AI询问健康数据 - 发送通知 - 查看屏幕时间 - 每个工具调用都会记录在应用的Audit标签页中7. 注意事项重要提示隐私保护所有数据完全在本地处理源代码不会离开设备。唯一的网络流量是许可证验证和聚合使用统计端到端加密TLS在手机上终止中继仅做SNI透传从不看到明文数据会话临时性会话是临时的客户端断开连接后手机会回到休眠状态冷启动时间冷启动唤醒约需3秒许可协议Apache License 2.0状态v1.0已发布22个工具跨4个集成端到端加密工作原理AI客户端 ──TLS── 中继(SNI透传) ──mux WebSocket(mTLS)── 你的手机 1. 启用集成并获得URL 2. 将URL添加到Claude、Cursor或其他MCP客户端 3. 客户端连接时中继通过FCM推送唤醒手机 4. 手机通过mTLS WebSocket回连中继拼接两个TLS流 5. AI客户端通过端到端加密TLS直接与手机通信 6. 会话结束后手机回到休眠