MM

mariyafilippova/mcp-strava

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

21 stars 2 forks 质量 56 趋势 14

MCP Strava 服务器促进了 Strava API 与 Claude for Desktop 之间的无缝集成。

概览

一款集成Strava与Claude桌面版的模型上下文协议(MCP)服务器,实现AI驱动的健身活动分析。 - ⭐ - 通过谷歌地图链接建议往返路线(无需API密钥) - ⭐ - 发现附近热门Strava路段并获得谷歌地图环圈 - 自动刷新和持久化 - - 按ID获取任何活动详情,或浏览近期活动 - - 心率、配速、海拔、步速、功率、GPS导航 - - 每圈距离、时间、速度、海拔和心率 - - 跑步最快400米、1公里、1英里、5公里、10公里等,配速和个人最佳排名 - - 按日期范围查找活动并完整分页 - - 比较月与年-- 历史统计数据,周/月总结 - - 按活动类型(跑步、骑行、游泳等) 从Strava的API设置中获取你的凭证。 JAR会在:build/libs/strava-mcp-server-2.1.0-all。

概述(AI 翻译)

一款集成Strava与Claude桌面版的模型上下文协议(MCP)服务器,实现AI驱动的健身活动分析。

特色

  • ⭐ 路线生成 - 建议带有谷歌地图链接的往返路线(无需API密钥)
  • ⭐ 热门路线 - 发现附近热门Strava路段,并通过谷歌地图环游
  • OAuth 认证,具自动令牌刷新和持久化功能
  • 活动分析 - 按ID获取任何活动详情,或浏览近期活动
  • 数据流 - 心率、配速、高度、步频、功率、任何活动的GPS
  • 单圈分段 - 每圈距离、时间、速度、海拔和心率
  • 个人最佳成绩 - 最快400米、1公里、1英里、5公里、10公里等,包含配速和个人最佳排名
  • 分页搜索 - 按日期范围查找活动,带完整分页
  • 历史比较 - 比较月份与年份
  • 统计数据 - 历史统计,周/月总结
  • 过滤 - 按活动类型(跑步、骑行、游泳等)

可用工具

工具 描述
auth_strava 用Strava授权(打开浏览器)

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

MCP Strava Server

A Model Context Protocol (MCP) server that integrates Strava with Claude for Desktop, enabling AI-powered analysis of your fitness activities.

Features

  • ⭐ Route Generation - suggest round-trip routes with a Google Maps link (no API key needed)
  • ⭐ Popular Routes - discover popular Strava segments nearby and get a Google Maps loop through them
  • OAuth Authentication with automatic token refresh and persistence
  • Activity Analysis - get details on any activity by ID, or browse recent ones
  • Data Streams - heart rate, pace, altitude, cadence, power, GPS for any activity
  • Lap Splits - per-lap distance, time, speed, elevation, and heart rate
  • Personal Best Efforts - fastest 400m, 1k, 1 mile, 5k, 10k, etc. for a run, with pace and PR ranking
  • Paginated Search - find activities by date range with full pagination
  • Historical Comparisons - compare months year-over-year
  • Statistics - all-time stats, weekly/monthly summaries
  • Filtering - by activity type (Run, Ride, Swim, etc.)

Available Tools

Tool Description
auth_strava Authorize with Strava (opens browser)
logout Clear stored tokens to switch accounts
last_activity Get details of your most recent activity
get_activity Fetch any activity by its ID
recent_activities List last 10 activities
search_activities Paginated search with optional date range (before/after epoch, page, per_page)
athlete_stats All-time statistics (rides, runs, swims)
activities_by_type Filter activities by sport type
weekly_summary Summary of the past 7 days
monthly_summary Summary of the past 30 days
month_summary Summary for a specific month/year
compare_months Compare two months (e.g., Jan 2025 vs Jan 2026)
get_streams Heart rate data for last activity
get_activity_streams Full data streams (HR, pace, altitude, cadence, power, GPS, etc.) for any activity
get_laps Lap splits for any activity (distance, time, speed, elevation, HR)
get_best_efforts Personal best efforts (400m, 1k, 1 mile, 5k, 10k, …) for a run, with pace and PR ranking
suggest_route Generate a round-trip route and get a Google Maps link for navigation
popular_routes Find popular Strava segments nearby and build a Google Maps route through them

Setup

1. Clone the Repository

git clone https://github.com/MariyaFilippova/mcp-strava.git
cd mcp-strava

2. Configure Strava API Credentials

Get your credentials from Strava API settings.

Create/edit src/main/resources/.env:

CLIENT_ID="your-client-id"
CLIENT_SECRET="your-client-secret"

3. Build the Project

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "strava": { "command": "java", "args": [ "-jar", "/absolute/path/to/mcp-strava/build/libs/strava-mcp-server-2.1.0-all.jar" ] } } }