Strava MCP Server

Strava MCP 服务器

用于与 Strava API 交互的模型上下文协议 (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 桌面：将以下内容添加到您的 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 （可选）：用于过滤的纪元时间戳
• after （可选）：用于过滤的纪元时间戳
• 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 运行服务器：

手动身份验证

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

项目结构

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

运行测试

发布到 PyPI

构建包

发布到 PyPI

执照

MIT 许可证

致谢

• Strava API
• 模型上下文协议（MCP）