Paceva

面向开发者的 Paceva

Paceva 将耐力运动员的手表数据转化为可靠的赛事预测： 给出范围，并根据运动员自己的历史数据进行验证。本仓库介绍其 公开接口：Paceva MCP 服务、前置的 OAuth 2.1 登录，以及 Paceva 如何连接到 Intervals.icu。

Paceva 应用本身为闭源。本仓库仅包含文档和 示例。

一分钟内完成连接

服务 URL： https://paceva.app/api/mcp

应用	操作方法
Claude（claude.ai、桌面端、移动端）	前往 Settings → Connectors → Add custom connector，粘贴 URL，登录 Paceva 并批准。
ChatGPT	前往 Settings → Apps & Connectors → 使用该 URL 添加自定义连接器（部分套餐需要启用开发者模式）。
Claude Code	运行 claude mcp add --transport http paceva https://paceva.app/api/mcp，然后输入 /mcp 登录。
Cursor / VS Code	使用 paceva.app/dashboard/ai 上的一键按钮，或将其添加为 Streamable HTTP 服务。
其他应用	任何支持 Streamable HTTP 和带 PKCE 的 OAuth 2.1 的 MCP 客户端。

然后可以询问诸如 “我今天该不该进行高强度训练？”、“我现在游 1500 米能达到什么成绩？” 或 “我上一个骑行训练周期表现如何？” 等问题。

完整指南：docs/connect.md。

本仓库内容

文档	用途
docs/connect.md	如何连接各类 AI 应用，以及使用预期
docs/tools.md	每个 MCP 工具、参数及返回内容
docs/oauth.md	OAuth 2.1 服务：发现、PKCE、客户端注册、令牌
docs/intervals-icu.md	手表数据接入方式：Intervals.icu 登录分步说明
docs/data-and-privacy.md	AI 应用可以和不可以查看的内容
docs/listing.md	MCP Registry 条目（server.json）以及可提交到的目录
examples/	curl 发现、原始 JSON-RPC 调用、客户端配置片段

基本原则

• 只读。 仅有一个权限范围 paceva:read。所有工具都不会写入数据。
• 仅限你自己的数据。 令牌绑定到一个 Paceva 账户，绝不会读取他人的数据。
• 每个数值都有标注。 device 值来自你自己的手表（例如 Garmin 的 HRV）；paceva 值由 Paceva 计算得出。
• 预测以范围表示。 工具会返回低值至高值的范围，以及该范围对你而言的命中频率。请引用范围，而非单一成绩。
• 可撤销。 在 Paceva → Use with AI 中断开任意应用后，其令牌会在下一次调用时失效。

状态

项目	状态
MCP 服务 + OAuth	已上线
Intervals.icu 同步（Garmin、Coros、Wahoo、Polar、Suunto）	已上线
Paceva 网页仪表板	即将推出，加入候补名单
iPhone 应用（Apple Health）	即将推出

安全

发现问题？请发送邮件至 [email protected]，不要公开提交问题。请参阅 SECURITY.md。

许可证

本仓库中的文档和示例采用 MIT 许可证。Paceva 名称和 徽标不在许可范围内。