Skip to main content
Glama
seselcuk
by seselcuk

Antrenör MCP — 实验/学习项目

这不是生产环境。 这是为了体验主 Antrenör 应用的 MCP(模型上下文协议)版本而创建的副项目。目的:学习 MCP 架构,展示如果集成到主项目中会是什么样子。

架构

mcp_servers/data/demo.db  (SQLite — uydurma seed veri)
        ↑                    ↑
   MCP server'lar        Streamlit
   (Claude Desktop)      (localhost:8501)

关键思路: 一个数据源,两个不同的客户端 — 一个对话式(Claude Desktop + MCP),一个可视化(Streamlit)。

Related MCP server: fitness-mcp-server

与主项目的区别

主项目(生产环境)

本实验

模型访问

推送模式 — Worker 将上下文粘贴到 prompt 中

拉取模式 — Claude 从 MCP 服务器拉取

客户端

iOS + Streamlit

Claude Desktop + Streamlit

部署

Cloudflare Workers + D1

本地 Python

数据源

真实的 Garmin API

虚构的 SQLite 种子数据

目的

为用户创造价值

学习/展示架构

MCP 服务器

  1. garmin — 活动历史、健康数据、心率区间分布、周训练负荷(来自 SQLite)

  2. pain — 疼痛历史 + 记录新疼痛(在 SQLite 中 INSERT)

  3. coach-rules — 作为 prompt 模板的 coach-principles.md + pain-rubric.md

详细信息和 API 请参阅:mcp_servers/README.md

快速开始

# 1. Bağımlılıklar
python3.11 -m venv .venv
.venv/bin/pip install -r requirements.txt

# 2. DB seed
.venv/bin/python -m mcp_servers.data.seed

# 3. Claude Desktop config kur
cp mcp_servers/claude_desktop_config.example.json \
   "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 4. Claude Desktop'ı restart (Cmd+Q sonra yeniden aç)

# 5. Streamlit dashboard (opsiyonel, görsel demo için — port 8502, ana projenin 8501 ile çakışmaz)
.venv/bin/streamlit run streamlit_demo/app.py --server.port 8502

演示场景

演示中使用的 3 个场景及流程请参阅:DEMO.md

文件夹结构

antrenör_mcp/
├── mcp_servers/
│   ├── garmin/server.py       Aktivite + wellness + zone MCP
│   ├── pain/server.py         Ağrı geçmişi + log_pain tool
│   ├── coach_rules/server.py  Prensipler + rubric prompt template
│   ├── data/seed.py           DB seed script
│   ├── data/demo.db           SQLite (git'e girmez)
│   └── claude_desktop_config.example.json
├── streamlit_demo/app.py      3 tab dashboard
├── docs/
│   ├── coach-principles.md    Zone 2, shin, deload kuralları
│   └── pain-rubric.md         0-10 ağrı ölçeği
├── DEMO.md                    Sunum senaryosu
└── requirements.txt

Related MCP Connectors

  • Talk to your own gym log. Reps is a free workout tracker for iPhone and Android; connect it to Claude, ChatGPT or any MCP client and ask about your workout history, personal records, exercise progression, weekly summaries, routines and training plan. The assistant can also save a new routine, edit one, save a whole plan, add custom exercises and exercise notes, always after you confirm in the chat. It cannot log a workout or delete your history. Requires a free Reps account created in the app; you sign in with a one-time email code.

  • Pace is a remote MCP server that exposes wearable and fitness data to Claude via the Model Context Protocol. It connects to Garmin, Oura, Whoop, Polar, Fitbit and 20+ devices and provides 15 tools for querying sleep, activity, recovery, and training data. Hosted on Google Cloud Run, OAuth 2.1 authentication, Streamable HTTP transport. Instructions: First you need to create an account at: https://pacetraining.co and connect your wearables. After that you can connect the remote Server via Custom Connector in Claude and OAuth 2.1 Flow startet.

  • Apple Health training load, recovery, HRV and workout detail for Claude, ChatGPT and any MCP client.

  • Adaptive running coach MCP server — training data, plans, and recovery for AI assistants.

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables Claude to access and query your Garmin Connect data, including sleep, activities, training load, and health metrics, through a set of read-only MCP tools.
    28
    160 PyPI
    2
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides MCP servers for Claude to access fitness data from Strava and intervals.icu, enabling natural language queries for activity analysis, advanced training metrics, and wellness tracking.
    1
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables workout tracking and coaching within Claude conversations, managing exercise configs, logs, streaks, and health metrics via an MCP server with PostgreSQL.
    -