Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Long Run Hybrid Coach

de atomchungversión 1.4.10i★ 6iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.atomchung/long-run-hybrid-coach

Cómo instalar

What it does

Adaptive running and strength coaching for the long run.

  • Connects Se ejecuta en la nube
  • Account or key Sign in to the service when you connect (OAuth)
  • Category Otros

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad10/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso30/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Long Run Hybrid Coach. Sigue https://mcp.popnx.com/i/atomchung-long-run-hybrid-coach.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.paceandstaystrong.com) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreLong Run Hybrid Coach
    Remote MCP server URL · Direcciónhttps://mcp.paceandstaystrong.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsLong Run Hybrid Coach

  4. Pruébalo

    Usa Long Run Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Long Run Hybrid Coach o muestra una herramienta de Long Run Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreLong Run Hybrid Coach
    Connection · Direcciónhttps://mcp.paceandstaystrong.com/mcp
  3. Elige Long Run Hybrid Coach en un chat

    Abre un chat nuevo y elige Long Run Hybrid Coach en tus plugins antes de escribir

  4. Pruébalo

    Usa Long Run Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando Long Run Hybrid Coach o muestra una herramienta de Long Run Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user long-run-hybrid-coach https://mcp.paceandstaystrong.com/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver Long Run Hybrid Coach en la lista como conectado

  4. Pruébalo

    Usa Long Run Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Long Run Hybrid Coach o muestra una herramienta de Long Run Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa Long Run Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Long Run Hybrid Coach o muestra una herramienta de Long Run Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa Long Run Hybrid Coach y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Long Run Hybrid Coach o muestra una herramienta de Long Run Hybrid Coach en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.paceandstaystrong.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Long Run Hybrid Coach💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user long-run-hybrid-coach https://mcp.paceandstaystrong.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "long-run-hybrid-coach": {
      "url": "https://mcp.paceandstaystrong.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "long-run-hybrid-coach": {
      "type": "http",
      "url": "https://mcp.paceandstaystrong.com/mcp"
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
1.4.10
Categoríai
Otros
Publicado en el registroi
14 sept 2026
Último cambio de códigoi
13 nov 2026
Última revisión
18 nov 2026
Creador
atomchung
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub atomchung, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 262 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

La dirección en la nube respondió 4 de las últimas 4 comprobaciones · última 262 ms · revisado 18 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/atomchung-long-run-hybrid-coach.svg)](https://mcp.popnx.com/en/servers/atomchung-long-run-hybrid-coach)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 95% de los otros 20653 servidores de esta categoría
  • Publicado en el registro más recientemente que el 39% de los otros 20653 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 20653 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Long Run Hybrid Coach?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (1.4.10) llegó al registro hace 2 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 30 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
Long Run Hybrid Coach
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/54/44/44/41/44/4
LicenciaMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Long Run Hybrid Coach

繁體中文 · English · 简体中文

官網 paceandstaystrong.com | 遇到問題看支援頁

把一個網址貼進 Claude 或 ChatGPT,你就有一個讀得到你真實訓練的教練。

它讀你 Intervals.icu 帳號裡的活動與恢復數據,維持同一份 28 天的跑步+重訓方向與本週課表,拿計畫去對你實際做了什麼,並在你同意之後,把每一堂課排進你的日曆。免費使用,沒有付費方案。

Garmin 不是使用前提。 Garmin 只是目前第一條做過實機驗證的下游裝置路徑;Apple Watch、COROS、Polar、Suunto、Wahoo、其他 app/手錶,甚至沒有手錶,都可以用同一個教練。差別在於有多少可信的訓練紀錄能進到教練手上,以及 Intervals 後面那段裝置同步是否已經被驗證過。

一般使用者直接用託管版: https://mcp.paceandstaystrong.com/mcp。你需要一個 Intervals.icu 帳號,但不需要自己向 Intervals 申請 OAuth App,也不需要自己維運伺服器。


連接:兩步

官網把同一條流程拆成四個點擊步驟走一次:開始使用。

你需要什麼
  1. 一個 Intervals.icu 帳號。 免費,用 Google 登入大約 30 秒就能開好。
  2. Claude 或 ChatGPT。
  • Claude(claude.ai/Claude Desktop):免費方案就可以,免費帳號限一個自訂連接器。這條路徑已經做過完整實機驗證——production OAuth、教練對話、以及把課表送進 Intervals。
  • ChatGPT:目前需要 Business、Enterprise 或 Edu 的網頁版 workspace,在 Apps/developer mode 建立 custom app。個人方案的 custom MCP 只有 read/fetch,跑不完本產品「寫計畫+交付課表」的流程。ChatGPT 外掛程式目錄上另有這個教練的 Plugin 版。最新限制以 OpenAI 官方說明 為準。
  • 其他 MCP client:OpenClaw 與自架 client 見下面一節。
  1. 選配:已經會把活動同步進 Intervals.icu 的手錶或訓練 app。沒有手錶也可以用——教練會把拿不到的欄位當成「不知道」,不會當成 0。
第一步:把網址貼進你的 AI

在 AI 的連接器設定裡新增一個 remote MCP server,網址是:

https://mcp.paceandstaystrong.com/mcp
  • claude.ai/Claude Desktop:Settings → Connectors → Add custom connector → 貼上網址。
  • ChatGPT:Apps/developer mode → 建立 custom app → 指到同一個網址。

沒有別的欄位要填,也沒有金鑰要貼。

第二步:授權 Intervals.icu

瀏覽器會開 Intervals.icu 的同意頁。登入你自己的 Intervals.icu 帳號,四個權限都勾起來:

權限教練拿它做什麼
ACTIVITY:READ讀你已完成的訓練。
WELLNESS:READ讀 Intervals 手上的恢復數據。
CALENDAR:WRITE讀寫訓練日曆,讓你確認過的課表能送進去,並讀回來核對。
SETTINGS:WRITE讀你的門檻配速。它唯一會寫進去的,是你還沒有的門檻配速,發生在你已經確認過的課表交付當下;已經設好的絕不覆寫。

Intervals 也有只讀的設定權限;這裡要寫入,是因為上面那個補值動作真的會寫。它之所以需要,是因為 Intervals 這邊沒有門檻配速時,它照樣收下有配速的課表,但往手錶送的時候會把配速目標拿掉——你會收到距離正確、卻沒有任何目標的一堂課。少勾任何一個權限,需要它的功能就會壞掉,而且不容易看出原因;重新連線補上即可。

不要把 Intervals 密碼、API key 或 token 貼進對話。

在 ChatGPT 安裝 Plugin 版

ChatGPT 的外掛程式目錄上有這個教練的 Plugin 版,不用貼網址。先準備好一個 Intervals.icu 帳號,而且手錶的訓練紀錄已經同步進去。

  1. 開啟 Long Run Hybrid Coach 的安裝頁,按「安裝外掛程式」。還沒登入 ChatGPT 的話,會先請你登入。
  2. 連接時登入你自己的 Intervals.icu 帳號並同意。Plugin 版只要三項權限:ACTIVITY:READ、CALENDAR:WRITE、SETTINGS:WRITE。
  3. 在 ChatGPT 的對話裡問它,例如「讀我最近的訓練,告訴我這週該怎麼練。」

Plugin 版從 Intervals.icu 只讀你完成的訓練(活動、配速、運動心率、訓練負荷),不讀那裡的恢復數據。它的計畫和完整版(上面的個人 MCP 連線,https://mcp.paceandstaystrong.com/mcp)各自獨立,不互通。

Intervals 帳號是新的或空的?

教練讀的是 Intervals.icu 裡已經有的東西。帳號是新的話,有兩條路把歷史補進去:

  • 接上你原本就在用的裝置或 app。 在 Intervals.icu 自己的 Settings 裡連 Garmin 或你的手錶/訓練 app,過去的活動會自動補上。資料到了之後,再請教練重新讀一次。
  • 把匯出檔直接交給教練。 在對話裡給它 CSV、Apple Health 匯出檔或 .fit 檔,請它匯入。同檔與同一場活動會自動去重,判斷不了才回頭問你。(檔案是給教練的,不會進 Intervals.icu。)

裝置量不到的東西也可以直接在對話裡講:重訓的實際組數重量次數、本週能練的時間與器材、體重體脂、沒帶錶的那一場、「最近很累」「睡不好」,以及你從手錶上實際看到的睡眠、HRV、靜止心率、readiness 數字。教練不會把一句「我很累」偷偷翻成一個假的 readiness 分數。


連上之後會發生什麼

直接問正常的教練問題

不用先填問卷:

讀我最近的訓練,告訴我這週該怎麼練。

或:

我想提升 VO2max,又不想掉力量,幫我排第一個 28 天方向。

教練會先讀已經有的資料,再只問真正會改變決策的缺口——例如本週可練日、器材,或裝置不可能知道的重訓基準。

第一次會先看 28 天預覽,你同意才寫進去
  • 本週:精確、可執行、可以直接送進日曆的課。
  • 後三週:大方向,不假裝現在就知道所有細節。

之後每一次改動也是同一條體驗:改動前後對照 → 你同意一次 → 才寫入。

要送進日曆時,再確認一次

交付是另一個獨立確認:課表預覽 → 你同意一次 → 寫進 Intervals.icu → 讀回來核對。

預覽會先說明這次要寫進哪一個 Intervals.icu 帳號——先講 Intervals 上的 email,再講顯示名稱,所以同時有正式帳號和測試帳號的人,在寫進去之前就看得出來是哪一個。email 放前面,是因為自己的兩個帳號常常取同一個顯示名稱。兩者都是當下向 Intervals 讀的,只用在這一次回答,不會被存下來。

本產品能證明的最遠一步是 Intervals.icu 收下了。Intervals 成功不等於課表已經在 Garmin、Apple Watch 或其他手錶上——Intervals 後面那段同步是外部路徑,要各自驗證。


Intervals.icu 在這個產品裡做什麼?

Intervals.icu 是目前的中轉站:它幫教練接住不同裝置/app 的活動與恢復數據,也承接教練確認後的日曆課表。它不是計畫本身的存放處。

手錶 / 訓練 app

│ ▼ Intervals.icu ───── 已完成活動 + 恢復數據 ─────► 教練 ▲ │ │ │ └────────── 你確認過的日曆課表 ◄───────────┘ │ ▼ Garmin / Apple Watch / 其他下游同步

責任分工:

  • Intervals.icu:整合外部訓練資料,並持有日曆。
  • Long Run Hybrid Coach:持有唯一的當前計畫、決策歷史、你自己回報的紀錄、每一次確認的綁定,以及整條教練流程。
  • 你的手錶/app:可以把活動帶進 Intervals,也可能接收 Intervals 往下送的課表;但最後一哩是否成功,要獨立驗證。

只有帳號本身是必要條件。Intervals 裡已經有活動與恢復數據的話,教練自動拿得到的資料會比較完整;沒有的欄位保持「不知道」,不會被當成 0,也不會因為少一個選配數值就把一般教練對話擋掉。


託管版 vs 自架

實際會感覺到的差別只有一個:託管版你在手機上就能直接用;自架只有在跑伺服器的那台電腦上能用。下面每一行都是這個差別的成本。

託管版(推薦)自架
手機上能用嗎能——連一個有手機 App 的 client 就好不能,除非你自己把伺服器對外開放並處理 TLS
網址https://mcp.paceandstaystrong.com/mcp你自己的伺服器,例如 http://127.0.0.1:8422/mcp
維運不用自己管自己啟動、更新、備份與維運
Intervals OAuth App不需要需要自己的 OAuth application 憑證
計畫存哪託管端、以每位使用者為範圍你自己的伺服器 state root
適合誰一般使用者、多個 client 共用同一份計畫開發者、需要完全自管環境/資料的人

託管版會自己處理 dynamic client registration、PKCE、token 與使用者對應;一般使用者不需要任何 id、API key、client secret 或環境變數。

其他 MCP client
  • OpenClaw:用 openclaw mcp add 指到同一個網址,加上 --auth oauth。一個 instance 若不只一個人用,要把 OAuth identity 設成 per-requester,否則所有人會連到同一個 Intervals 帳號。設定見 entrypoints/openclaw/。
  • 其他:把同一個網址設成 remote Streamable HTTP MCP server。跑在你自己機器上的 client(OAuth callback 落在 loopback)可以直接連;跑在雲端主機、用自己網域接 callback 的 client 也能自行註冊連上,只是在進到 Intervals 授權之前,會先看到本產品自己的一頁確認畫面,上面寫明授權會被送到哪一個 origin,按下 Continue 才會繼續。該 origin 若已被維運者驗證並加進清單,就直接跳過這一頁。細節見 entrypoints/mcp/README.md。

逐入口「已完整實機驗證」或「已封裝、等待真實連線驗證」的狀態,以 entrypoints/ 為準。

自架怎麼跑?

Repo 使用 Python 3.11,只有一個釘死版本的依賴:官方 MCP Python SDK(requirements.txt 寫版本,requirements.lock 連同它解析出的每個套件一起釘死 sha256),它負責 /mcp 的協定與傳輸層。教練判斷、驗證、store、交付與身分都仍然只用標準函式庫。

  1. Clone repo,然後 python3 -m pip install --require-hashes -r requirements.lock。
  2. 向 Intervals.icu 申請建立 OAuth application。 Intervals 目前的公開流程不是在 Settings 自助新增:依官方說明提供 app name、description、website、logo、privacy policy、redirect URI 與你的 Intervals ID;app 建立後才會出現在 Settings,從 Manage App 取得 client_id / secret。流程見 Intervals.icu OAuth support。
  3. 在 Intervals app 裡註冊 callback: /oauth/callback。本機 client 可以走 loopback;remote client 需要可達的 HTTPS 或安全通道。
  4. 設定必要環境變數:
export GARMIN_COACH_LOOP_GATEWAY_STATE_ROOT="$HOME/.local/share/long-run-hybrid-coach-gateway"

export GARMIN_COACH_LOOP_TOKEN_HMAC_KEY="$(openssl rand -base64 32)" export GARMIN_COACH_LOOP_INTERVALS_CLIENT_ID="..." export GARMIN_COACH_LOOP_INTERVALS_CLIENT_SECRET="..."

  1. 啟動:
python3 -m garmin_coach_loop.cli serve-gateway --host 127.0.0.1 --port 8422
  1. 本機 MCP client 指到 http://127.0.0.1:8422/mcp。

要正式提供給 remote client 的話,不要把 loopback 範例當 production runbook。Persistent volume、TLS、信任的 client origin、single replica、release identity 與部署驗證見 docs/deploy-gateway.md。

一個人只該有一份當前計畫

本機設定 GARMIN_COACH_LOOP_GATEWAY_URL 指向託管版時,本機寫入預設會被擋;只有明確加 --offline 才代表「我刻意在做另一份本機計畫」。已經有本機資料的人可以搬到託管版,流程見 docs/ops/migrate-local-store-to-hosted.md。


現在可以做什麼?

  • 維護一份 28 天方向:本週精確的課 + 後三週大方向。
  • 讀 Intervals 的活動、恢復數據與日曆,把可信的「排了什麼 vs 實際做了什麼」自動對回當前計畫。
  • 在同一份週計畫裡同時處理跑步與重訓。
  • 記錄你自己回報的東西:個人資料、可練時間、長期目標、訓練習慣、實際重訓、體重體脂、裝置沒錄到的活動,以及主觀狀態。
  • 每次對話可以帶入當下的恢復數字。託管版不會、也不需要去讀你電腦上的健康資料庫。
  • 匯入歷史資料:支援格式的 CSV、Apple Health XML,以及 FIT 檔。同檔與同一場活動會自動去重,判斷不了才問你。
  • 課表可以帶一段教練備註一起進 Intervals,而不是偷偷長出第二套課表寫法。
  • 每週複盤「實際練了什麼、有沒有進步的證據、下一步是什麼」,而不是把「課表做完」直接當成體能提升。
  • 計畫變更先看對照,同意後才套用。
  • 日曆交付先看預覽,同意後才寫入;支援安全重試、取代與撤回本產品自己送出去的課表。
  • 在對話裡直接匯出本產品持有的資料。刪除整個帳號改為寫信申請,教練會直接給你說明要寄什麼的頁面。
重要邊界
  • 開始一次教練對話會做自動對帳,可能寫入新的計畫版本。只想看目前存了什麼、完全不動到資料的話,用唯讀的那條路徑(getCoachState)。
  • 你自己回報的活動是佐證資料,不會被偷偷升格成裝置確認的完成紀錄。
  • 恢復數字只接受真的觀察值;模型不可以從文字自己猜一個數字出來。
  • 本產品不做醫療診斷。
  • 交付的證據只到 Intervals 讀回來核對,不會聲稱已經到手錶。

資料、匯出與刪除

託管端保存維持同一份計畫所必要的東西:計畫的版本鏈、決策與回執、你自己回報的紀錄、身分對應,以及還沒收斂的交付紀錄。

匯出時刻意不包含三樣東西:授權憑證的 fingerprint(單向的指紋,只拿來做內部記帳)、供應商的原始 payload 與 GPS 軌跡(原始活動檔應該跟供應商拿),以及內部的 owner id(本產品自己的儲存位置編號)。

刪除也有三個明確邊界,這三件不在本產品能刪的範圍:

  • 已經寫進 Intervals.icu 日曆的課表;
  • 你在 Intervals.icu Settings 給出的授權;
  • 不含計畫、健康或身分內容的最小化平台營運紀錄。

匯出在對話裡自己做。刪除整個帳號是寫信申請,流程在支援頁:要的是你的 Intervals.icu athlete id,以及一張 Intervals.icu Settings 頁的截圖;不會跟你要密碼、API key 或 token。在對話裡要求刪除全部資料,教練只會給你這一頁——在你寄信之前,沒有提交,也沒有刪除任何東西。

1.4.5 之前刪除是兩次 tool call 加一次確認。有些 AI 用戶端會在自己的核准層擋掉那次確認,服務端完全收不到訊息,使用者手上只剩一份預覽、資料沒被刪掉。改成一條一定走得完的路,取代兩條中間可能斷掉的路。

完整生命週期見 docs/account-lifecycle.md,公開隱私政策在 paceandstaystrong.com/zh/privacy.html(英文版為準)。


目前限制

  • 教練不直接登入 Apple Health、Garmin Connect 或其他裝置帳號;主要的自動資料路徑目前仍是 Intervals.icu。
  • 託管版會按日期保存你提供的睡眠分數、睡眠時長、昨夜 HRV 與靜息心率,直到你刪除帳號資料。教練每次讀取最近 28 天,這不是保存期限;其他傳入的恢復數字只供當次判斷。要拿掉某一天的恢復紀錄,說那天的紀錄不算即可,但那一天是整筆拿掉,不能只留其中一個數字,詳見 資料說明。
  • 本產品不觀察 Intervals 之後的每一段裝置同步,因此不會把「Intervals 收下了」說成「已經在手錶上」。
  • 自架是給開發者/自管的人;一般使用者應優先用託管版。
  • 裝置相容性是逐條路徑的證據,不會因為 Garmin 已驗證就推論其他裝置一定相同。
  • 這是一個人的專案,不是公司。不保證服務不中斷,也可能改變。

遇到問題

  • [支援頁](https://paceandstaystrong.com/zh/support.html):匯出、刪除、更正、撤銷授權。匯出與更正你在對話裡自己做;刪除整個帳號是這一頁說明的寫信申請。上面也有直接寄給開發者的信箱。
  • [Issue tracker](https://github.com/atomchung/long-run-hybrid-coach/issues):bug 與功能建議。它是公開且永久的,不要貼健康/訓練/計畫內容、Intervals 的 athlete id、token 或任何憑證。要指認自己的帳號,用你資料匯出檔裡那個不可還原的參照碼就夠了。
  • 認為是資安或隱私漏洞的話,不要公開描述,直接寄信。

技術文件

目前 release 對外有 24 個 MCP tool、2 個 prompt、34 個 CLI 指令、4 份 JSON Schema contract、12 張 identity 表。這些數量由測試從真實程式碼推導,避免這份文件自己走鐘。

Long Run Hybrid Coach 是獨立專案,與 Garmin、Intervals.icu、Apple 或其他裝置/平台供應商沒有隸屬、背書或贊助關係。程式碼以 MIT License 釋出。