Strava MCP Server

Strava MCP Server

site icon
2025.03.24 0
Python运动数据分析健身追踪社交互动路线可视化位置服务娱乐功能
Strava MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 Strava API 的访问。该服务使语言模型能够与 Strava 数据进行交互,包括活动、运动员信息等。核心功能包括活动跟踪与分析、运动员统计、路线可视化、成就追踪和社交功能(如点赞和评论)。适用于运动数据分析、个人健身追踪和社交互动等场景。
View on GitHub

Overview

基本能力

产品定位

Strava MCP Server 是一个连接语言模型与 Strava 数据的中间件服务,专注于运动数据的获取、分析和可视化。

核心功能

  • 🏃‍♂️ 活动跟踪与分析
  • 📊 运动员统计
  • 🗺️ 路线可视化
  • 🏆 成就追踪
  • 🤝 社交功能(点赞、评论)

适用场景

  • 个人健身数据追踪与分析
  • 运动表现比较与趋势分析
  • 社交互动与成就分享
  • 路线规划与可视化

工具列表

  1. Strava API:提供原始运动数据访问
  2. Map Utilities:用于路线可视化
  3. HTTP Server:提供RESTful API接口
  4. MCP Server:与语言模型交互的协议实现

常见问题解答

  • 如何获取Strava API凭证? 访问 https://www.strava.com/settings/api 创建应用并获取凭证
  • 如何保护敏感信息? 使用.env文件存储凭证,确保不被提交到版本控制

使用教程

使用依赖

# 需要Python 3.12+
python --version
# 需要pip
pip --version

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp
  1. 创建虚拟环境:
python -m venv venv
source venv/bin/activate  # Windows: .\venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt
  1. 配置环境变量:
# 在config/.env文件中配置
STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

调试方式

  1. 启动HTTP服务器:
./run_server.sh
  1. 测试API端点:
curl http://localhost:8000/activities/recent
  1. 检查MCP连接:
python src/strava_server.py

许可证

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