Strava MCP 服务器

一个用于与 Strava API 交互的模型上下文协议 (MCP) 服务器。

<a href="https://glama.ai/mcp/servers/@yorrickjansen/strava-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@yorrickjansen/strava-mcp/badge" alt="Strava Server MCP server" /> </a>

用户指南

安装

您可以使用 uvx 轻松安装 Strava MCP：

uvx strava-mcp

设置 Strava 凭据

1. 创建 Strava API 应用程序：

   • 前往 https://www.strava.com/settings/api
   • 创建一个新的应用程序以获取您的客户端 ID 和客户端密钥
   • 对于“授权回调域”，输入 localhost

2. 配置您的凭据： 创建一个凭据文件（例如，~/.ssh/strava.sh）：

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

3. 配置 Claude Desktop： 将以下内容添加到您的 Claude 配置 (/Users/<username>/Library/Application Support/Claude/claude_desktop_config.json)：

   "strava": {
       "command": "bash",
       "args": [
           "-c",
           "source ~/.ssh/strava.sh && uvx strava-mcp"
       ]
   }
   

身份验证

首次使用 Strava MCP 工具时：

1. 身份验证流程将自动启动
2. 您的浏览器将打开到 Strava 授权页面
3. 授权后，您将被重定向回本地页面
4. 您的刷新令牌将自动保存以供将来使用

可用工具

获取用户活动

检索已验证用户的活动。

参数：

• before（可选）：用于过滤的 Epoch 时间戳
• after（可选）：用于过滤的 Epoch 时间戳
• page（可选）：页码（默认值：1）
• per_page（可选）：每页的项目数（默认值：30）

获取活动

获取有关特定活动的详细信息。

参数：

• activity_id：活动的 ID
• include_all_efforts（可选）：包括分段努力（默认值：false）

获取活动分段

从特定活动中检索分段。

参数：

• activity_id：活动的 ID

获取分段排行榜

获取特定分段的排行榜。

参数：

• segment_id：分段的 ID
• 各种可选过滤器（性别、年龄组等）

开发者指南

项目设置

1. 克隆存储库：

   git clone <repository-url>
   cd strava
   

2. 安装依赖项：

   uv install
   

3. 设置环境变量：

   export STRAVA_CLIENT_ID=your_client_id
   export STRAVA_CLIENT_SECRET=your_client_secret
   

   或者，创建一个包含这些变量的 .env 文件。

在开发模式下运行

使用 MCP CLI 运行服务器：

mcp dev strava_mcp/main.py

手动身份验证

您可以通过运行以下命令手动获取刷新令牌：

python get_token.py

项目结构

• strava_mcp/: 主包目录
  • __init__.py: 包初始化
  • config.py: 使用 pydantic-settings 的配置设置
  • models.py: Strava API 实体的 Pydantic 模型
  • api.py: Strava 的低级 API 客户端
  • auth.py: Strava OAuth 身份验证实现
  • oauth_server.py: 独立的 OAuth 服务器实现
  • service.py: 用于业务逻辑的服务层
  • server.py: MCP 服务器实现
• tests/: 单元测试
• strava_mcp/main.py: 运行服务器的主要入口点
• get_token.py: 用于手动获取刷新令牌的实用程序脚本

运行测试

pytest

发布到 PyPI

构建包

# 构建 sdist 和 wheel
uv build

发布到 PyPI

# 首先发布到 Test PyPI
uv publish --index testpypi

# 发布到 PyPI
uv publish

许可证

MIT 许可证

致谢

• Strava API
• 模型上下文协议 (MCP)