MCP Server Strava

ИиийлйациаStrava API模型上下文协议（MCP）SDK

集成使用Model Context Protocol SDK分析训练并从Strava数据中获取建议。

🚀 机会

• Strava训练分析
• 培训建议
• 自动更新令牌
• API请求的速率限制

📋 要求

• Python 3.10+
• 克劳德桌面
• 斯特拉瓦 帐号
• 紫外线 （建议）

⚙️ 安装

# Клонируем репозиторий
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公司

1. 转到 API设置页
2. 创建应用程序：

- 应用名称：MCP Strava集成 - 类别：培训分析 - 网站： - 授权回调域：localhost

环境配置

1. 创建一个环境变量文件：

   cp .env-template .env

1. 获取访问令牌：

   python scripts/auth.py

1. 检查设置：

   mcp dev src/server.py
   curl -X GET "http://localhost:8000/activities"

📚 API和示例

资源和工具

使用示例

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≫代码覆盖报告≫

安全与秘密

1. 代币保护：

- .env 在 .gitignore - GitHub秘密CI/CD - 速度限制：100次查询/15分钟

1. Настройка секретов:

   # В GitHub: Settings → Secrets → Actions
   STRAVA_CLIENT_ID=
   STRAVA_CLIENT_SECRET=
   STRAVA_REFRESH_TOKEN=

贡献

1. 强制存储库

1. 建立依赖关系： uv pip install -e ".[dev]"

1. 创建分支： git checkout -b feature/name

1. 检查更改：

   ruff format .
   ruff check .
   pytest --cov=src

1. 创建Pull Request

📫 支持

• GitHub问题： 创建issue
• 电报： @格雷格·基塞尔

📄 许可证

麻省理工学院