用途 bosch-flow-mcp 是一个 MCP（Model Context Protocol）服务器，用于访问 Bosch eBike Flow（Smart System / BES3）的数据。它使用用户自己的 Bosch eBike Flow 账号登录（通过标准 SingleKey ID 登录），仅读取用户本人的数据，且为只读操作——不会修改自行车、电池或账号。
主要能力
- 电池状态随时间变化的快照：充电循环次数、已输出能量、衰减趋势
- 部件与固件版本：驱动单元、电池、ConnectModule、头显单元、遥控器、ABS
- 服务簿历史与软件更新日志（仅 EU Data Act 客户端）
- 通过移动 API 从 ConnectModule 获取实时电量（state-of-charge）
- 电池容量测试结果（仅 EU Data Act 客户端）
- 每次骑行活动数据：距离、爬升、速度、踏频、实测骑行者功率、卡路里、骑行者与电机的能量占比、助力模式分布、CO2、ABS 事件，以及逐点的 GPS/速度/爬升/功率轨迹
- 按需自动同步——工具会按需获取最新数据，无需 cron 任务
数据来源与认证 该服务器使用 Bosch Mobile API（obc-rider-profile.prod.connected-biking.cloud）作为主要数据源，使用 rider-activity API（obc-rider-activity.prod.connected-biking.cloud）获取每次骑行数据，并可选支持 Data Act API（api.bosch-ebike.com）以获取更多端点。 认证使用 one-bike-app 公共客户端（与 Bosch eBike Flow 移动应用相同的 OAuth 客户端），采用 PKCE，无需 API 密钥或注册，只需用户的 Bosch Flow 账号。 如果用户提供自己的 EU Data Act API 凭证，则会使用官方 Data Act API；否则会用用户自己的登录查询手机应用已经使用的同一应用 API。
使用方式 需要 Python 3.13+（在 3.13 与 3.14 上测试，支持 Linux、macOS、Windows），以及 uv（推荐）或 pip。还需要一个 Bosch eBike Flow 账号（免费）和一辆在应用中注册的 BES3 Smart System 电动自行车。 可通过 uvx bosch-flow-mcp 免安装运行，也可从克隆仓库进行开发。 认证时会打开浏览器跳转到 Bosch 登录。重要提示：登录前需打开浏览器开发者工具（F12）并切换到 Network 标签；登录后浏览器会重定向到一个桌面浏览器无法打开的 iOS URI（onebikeapp-ios://），需从 DevTools 复制完整重定向 URL（在 oauth2redirect 条目上右键 > Copy URL）并粘贴到提示处。令牌保存到 config/bosch_tokens.json，并通过 offline_access 自动刷新。 EU Data Act 用户：如果已注册自己的 euda 客户端并将其 ID 放入 config/bosch_config.json，则认证会使用该客户端，通过本地 http://localhost:4200 回调自动完成，无需 DevTools 步骤。 数据类型包括：bikes、batteries、components、service、software_updates、capacity。可使用 bosch_sync MCP 工具，或依赖自动同步（每个 get_* 工具在数据过期时会触发同步）。 可与 Claude Code 注册使用，随后可询问如“我今年的电池健康状况如何？”“按月展示充电循环趋势”“我的驱动单元固件版本是什么？”“我的自行车有服务记录吗？”“我这周的骑行距离和强度如何？”等问题。
适用场景 适合希望以只读方式查看自己 Bosch Smart System 电动自行车电池健康状况、部件固件、服务历史和骑行数据的用户，尤其是希望通过 MCP 与 AI 助手集成的用户。
限制与注意事项
- 这是非官方、社区构建的项目，未获得 Robert Bosch GmbH、Bosch eBike Systems 或 SingleKey ID 的关联、授权或认可。
- 使用未公开、非官方接口，若 Bosch 更改其系统，可能随时变化或停止工作。
- 用户需自行确保使用行为符合所在司法管辖区的 Bosch 和 SingleKey ID 服务条款。
- 服务簿历史、软件更新历史和容量测试结果仅来自 EU Data Act API，需要用户在 Bosch Data Act 门户注册自己的 euda 客户端；标准登录下这些类型会报告不可用（并附说明），而非静默返回空结果；Data Act API 对在欧盟以外注册的账号不返回任何内容。
- 软件按 GPLv3+ 提供，无任何担保，使用风险自负。
- OAuth 令牌在 POSIX 上以 0600 创建；Windows 忽略该模式，通过继承的 ACL 控制访问；令牌文件和 bosch_flow.db 已被 gitignore。
- 预提交钩子（scripts/check-no-data.sh）阻止提交数据库、令牌文件和密钥；测试使用临时 SQLite 数据库和虚构标识符，仓库中不会出现真实的自行车或账号数据。
