Интеграция Strava API с Model Context Protocol (MCP) SDK

Интеграция Strava API с Model Context Protocol (MCP) SDK

site icon
2025.04.17 0
Python训练数据分析运动建议服务位置服务
mcp-server-strava 是一个基于 Model Context Protocol (MCP) SDK 的 Strava API 集成服务,主要用于分析训练数据并提供训练建议。该服务支持自动更新令牌、API 请求的速率限制等功能,适用于运动爱好者和教练进行训练数据分析和管理。
View on GitHub

Overview

基本能力

产品定位

mcp-server-strava 是一个用于分析 Strava 训练数据并提供训练建议的服务,基于 Model Context Protocol (MCP) SDK 开发。

核心功能

  • 分析 Strava 训练数据
  • 提供训练建议
  • 自动更新令牌
  • 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() 获取训练建议

常见问题解答

  • 如何获取 Strava API 令牌? 通过 scripts/auth.py 脚本获取。
  • 如何检查服务是否正常运行? 使用 curl -X GET "http://localhost:8000/activities" 命令检查。

使用教程

使用依赖

  • Python 3.10+
  • Claude Desktop
  • Strava 账户
  • uv(推荐)

安装教程

# 克隆仓库
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]"

调试方式

  1. 设置环境变量
cp .env-template .env
python scripts/auth.py
  1. 启动服务并测试
mcp dev src/server.py
curl -X GET "http://localhost:8000/activities"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。