Strava MCP Server
2025.04.05
0
Python健身数据分析AI 助手集成位置服务开发效率
StravaMCP 是一个基于 Model Context Protocol (MCP) 的服务，用于连接 Strava API，允许用户通过 Claude 或其他 AI 助手访问和分析个人的健身数据。该服务支持获取活动记录、运动员统计、活动详情、路线和运动员个人信息等多种数据。
View on GitHub
Overview
基本能力
产品定位
StravaMCP 是一个连接 Strava API 的 MCP 服务器，旨在通过 AI 助手（如 Claude）访问和分析用户的健身数据。
核心功能
- 获取活动记录（跑步、骑行、游泳等）
- 获取运动员统计信息
- 获取活动详情
- 获取路线信息
- 获取运动员个人信息
适用场景
- 通过 AI 助手查询和分析个人健身数据
- 生成健身报告和统计信息
- 比较不同时间段的训练表现
- 分析训练模式和一致性
工具列表
| 工具名称 | 描述 | 参数 |
|---|---|---|
ping |
测试连接性 | 无 |
activities |
列出最近的活动 | per_page: 返回的活动数量（默认: 30）page: 页码（默认: 1） |
activity |
获取特定活动的详细信息 | activity_id: 活动 ID |
athlete |
获取个人资料信息 | 无 |
stats |
获取运动员统计信息 | athlete_id: 运动员 ID |
routes |
列出保存的路线 | per_page: 返回的路线数量（默认: 30）page: 页码（默认: 1） |
常见问题解答
- 连接问题：检查
.env文件中的凭证，确保已授予必要的权限。 - API 问题：401 未授权（令牌无效或过期），403 禁止访问（无权限），404 未找到（资源不存在），429 请求过多（达到 API 速率限制）。
- 调试：检查日志文件，确保配置正确，路径为绝对路径。
使用教程
使用依赖
- Python 3.10 或更高版本
- Strava 账户和 API 凭证（client ID, client secret, refresh token）
- Claude for Desktop 或其他兼容 MCP 的 AI 助手
uv包管理器（推荐）
安装教程
选项 1：使用 GitHub 仓库
- 克隆仓库：
bash git clone https://github.com/yourusername/strava-mcp.git cd strava-mcp - 安装依赖：
bash pip install -r requirements.txt # 或使用 uv： uv pip install -r requirements.txt - 创建
.env文件并填写 Strava API 凭证。
选项 2：从头开始设置
- 安装
uv：bash curl -LsSf https://astral.sh/uv/install.sh | sh - 创建项目：
bash uv init strava-mcp cd strava-mcp uv venv source .venv/bin/activate # Windows: .venv\Scripts\activate uv add "mcp[cli]" httpx python-dotenv - 下载或创建
strava.py文件。 - 创建
.env文件并填写凭证。
调试方式
- 运行服务器：
bash uv run strava.py # 或 python strava.py - 检查日志：
bash # macOS： tail -f ~/Library/Logs/Claude/mcp*.log # Windows： type %APPDATA%\Claude\Logs\mcp*.log - 使用 MCP 检查工具：
bash mcp inspect --server-id strava