Fitfly Engine

io.github.dropflyai由 GitHub 帳號 dropflyai 發布v0.2.0更新於 Oct 25, 2026

Deterministic fitness coaching engine: adaptive programs, progression math, readiness autoregulation

已驗證Streamable HTTP可網頁執行位置與生活資料與分析

概覽

AI 產生的概覽

遠端健身教練引擎,讓助理取得自適應訓練課表、記錄訓練、提交狀態自評,並管理訓練方案與營養目標。

可以做什麼
取得當日訓練,包含動作、組數次數、目標重量、營養目標與週期狀態,並自動套用狀態自評;記錄精力、睡眠與痠痛評分,得出準備度並調整訓練;以公斤記錄實際完成的重量,取得進階分析、個人紀錄辨識與下次目標;列出同肌群的有效替代動作,並依當日或整個方案替換動作;讀取或重新產生多日訓練方案;取得每日熱量與巨量營養目標及經 USDA 核對的餐食計畫;查看解釋教練決策的變更日誌。
適用情境
適合運動員或教練讓助理處理日常訓練:查看目前該做什麼、記錄已完成訓練、依疲勞調整、替換動作,或解釋課表為何變化。
執行需求
遠端 streamable HTTP 端點;必須在 Authorization 標頭中提供 bearer 權杖。FitFly 使用者透過引擎的權杖介面產生個人存取權杖,教練則透過合作夥伴 API 產生運動員權杖。
安裝前請注意
Authorization bearer 權杖屬於個人憑證,應妥善保密。記錄訓練、狀態自評、替換動作與重新產生方案都會寫入運動員已儲存的課表與歷史。方案重新產生與餐食計畫是較慢的 AI 呼叫,且巨量營養無法達成時餐食計畫可能僅為近似值。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Fitfly Engine,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.dropflyai%2Ffitfly-engine/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "fitfly-engine": {
      "type": "http",
      "url": "https://workout-engine-production-5dd7.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

工具

10

get_todays_session

Get today's training session

Today's workout: exercises, sets/reps, per-exercise load guidance and concrete target weights, plus nutrition targets and cycle status. Auto-applies the user's readiness check-in (autoregulation) if they've done one today. Call this to see what the athlete should do now.

輸入參數dayIndex

readiness_checkin

Log a readiness check-in

Record how the athlete feels today (energy, sleep, soreness — each 1–5). The engine scores readiness and, on the next get_todays_session, reshapes the workout accordingly (reduce volume / reduce intensity / recovery day). Returns the readiness score + modifier.

輸入參數sleep必填energy必填soreness必填

log_workout

Log completed sets

Record what the athlete actually lifted. The engine runs progression (double-progression, e1RM), detects PRs, and returns per-exercise outcomes (established/progressed/held/deloaded) with next-time targets. Weights are in kg.

輸入參數goaldayIndexexercises必填

list_swap_options

List same-area swap options for an exercise

Valid alternatives for an exercise — same muscle group, filtered to the athlete's equipment/level/injuries. Use before swap_exercise.

輸入參數exerciseId必填

swap_exercise

Swap an exercise

Replace an exercise with a valid same-area alternative. scope 'today' = just this session; scope 'program' = going forward. The new lift starts fresh (day-one calibration).

輸入參數scopedayIndexexerciseId必填toExerciseId必填

get_program

Get the active program

The athlete's current multi-day program (render-ready).

無需輸入參數。

regenerate_program

Regenerate the program

Rebuild the whole program from the stored profile (~20s AI generation). Use after a profile change or a plateau.

無需輸入參數。

nutrition_targets

Get nutrition targets

The athlete's daily calorie + macro targets, computed from body stats, activity, and goal.

無需輸入參數。

meal_plan

Generate a meal plan

A day of meals hitting the athlete's targets, USDA truth-checked (flags feasible=false with a note when macros are approximate). Slow (~15s AI call).

輸入參數exclusionsmealsPerDaytrainingDaydietaryStyle

changelog

What the engine changed and why

The 'what changed & why' feed — the engine's coaching decisions (volume bumps, deloads, swaps) in Coach Fly's voice. Use to explain to the athlete why their plan evolved.

輸入參數limit

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。