使用说明
Ииийлйациа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集成
- 类别：培训分析
- 网站： http://localhost
- 授权回调域：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, # ЧСС < 120
"medium": 4, # ЧСС 120-150
"hard": 2 # ЧСС > 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=<client_id> STRAVA_CLIENT_SECRET=<client_secret> STRAVA_REFRESH_TOKEN=<refresh_token>
贡献
-
强制存储库
-
建立依赖关系：
uv pip install -e ".[dev]" -
创建分支：
git checkout -b feature/name -
检查更改：
ruff format . ruff check . pytest --cov=src -
创建Pull Request
