ИиийлйациаStrava API模型上下文协议（MCP）SDK
集成使用Model Context Protocol SDK分析训练并从Strava数据中获取建议。
🚀 机会
- Strava训练分析
- 培训建议
- 自动更新令牌
- API请求的速率限制
📋 要求
⚙️ 安装
# Клонируем репозиторий
git clone https://github.com/rbctmz/mcp-server-strava.git
cd mcp-server-strava
# Установка через uv (рекомендуется)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install .
# Установка в режиме разработки
uv pip install -e ".[dev]"安装MCP SDK
uv add "mcp[cli]"🔧 设置
API Strava公司
- 转到 API设置页
- 创建应用程序：
- 应用名称：MCP Strava集成 - 类别：培训分析 - 网站： - 授权回调域：localhost
环境配置
- 创建一个环境变量文件：
cp .env-template .env- 获取访问令牌：
python scripts/auth.py- 检查设置：
mcp dev src/server.py
curl -X GET "http://localhost:8000/activities"📚 API和示例
资源和工具
| Тип | Название | Описание |
|---|---|---|
| 资源 | strava://activities 活动清单 | |
| 资源 | strava://activities/{id} | Детали активности |
| 资源 | strava://athlete/zones 训练区。 | |
| 资源 | strava://athlete/clubs | Клубы атлета |
| 资源 | strava://gear/{gear_id} 装备信息 | |
| 工具 | analyze_activity(activity_id) 训练分析 | |
| 工具 | analyze_training_load(activities) 负荷分析 | |
| 工具 | get_activity_recommendations() 推荐。 |
使用示例
from mcp import ClientSession
# Получение активностей
async with ClientSession() as session:
activities = await session.read_resource("strava://activities")
activity = await session.read_resource("strava://activities/12345678")
# Анализ тренировки
result = analyze_activity(activity_id="12345678")
"""
{
"type": "Run",
"distance": 5000,
"moving_time": 1800,
"analysis": {
"pace": 5.5, # мин/км
"effort": "Средняя"
}
}
"""
# Анализ нагрузки
summary = analyze_training_load(activities)
"""
{
"activities_count": 10,
"total_distance": 50.5, # км
"total_time": 5.2, # часы
"heart_rate_zones": {
"easy": 4, # ЧСС 150
}
}
"""
# Получение тренировочных зон
async with ClientSession() as session:
zones = await session.read_resource("strava://athlete/zones")
"""
{
"heart_rate": {
"custom_zones": true,
"zones": [
{"min": 0, "max": 120, "name": "Z1 - Recovery"},
{"min": 120, "max": 150, "name": "Z2 - Endurance"},
{"min": 150, "max": 170, "name": "Z3 - Tempo"},
{"min": 170, "max": 185, "name": "Z4 - Threshold"},
{"min": 185, "max": -1, "name": "Z5 - Anaerobic"}
]
},
"power": {
"zones": [
{"min": 0, "max": 180},
{"min": 181, "max": 250},
{"min": 251, "max": 300},
{"min": 301, "max": 350},
{"min": 351, "max": -1}
]
}
}
"""🛠 Разработка
CI/CD与安全
ПроверкивGitHub行动
| 类型 | 工具 | 描述 |
|---|
ÐLintingÐRuffÐÐÐÐÐÐÐÐÐÐ Pytest Unit和集成测试 ≫覆盖范围≫Pytest Cov≫代码覆盖报告≫
安全与秘密
- 代币保护：
- .env 在 .gitignore - GitHub秘密CI/CD - 速度限制：100次查询/15分钟
- Настройка секретов:
# В GitHub: Settings → Secrets → Actions
STRAVA_CLIENT_ID=
STRAVA_CLIENT_SECRET=
STRAVA_REFRESH_TOKEN=贡献
- 强制存储库
- 建立依赖关系：
uv pip install -e ".[dev]"
- 创建分支：
git checkout -b feature/name
- 检查更改：
ruff format .
ruff check .
pytest --cov=src- 创建Pull Request