Model Context Protocol (mcp) Server + Strava Oauth

该项目是一个基于Cloudflare Workers的MCP服务器，集成了Strava OAuth认证功能，允许用户通过Strava账号连接MCP服务。

健康与养生开发者工具 #OAuth认证 #MCP协议 #云服务 #运动数据 .TypeScript

评分 : 2.5分

下载量 : 8.6K

更新时间 : 2025-04-23

打开站点

什么是Strava MCP服务器?

这是一个特殊的AI连接服务器，允许用户使用他们的Strava运动账号登录，将运动数据安全地连接到AI助手(如Claude)中。服务器作为Strava和AI应用之间的桥梁，确保数据传输安全可靠。

如何使用这个服务?

只需在支持的AI应用中(如Claude Desktop)配置服务器地址，然后通过简单的授权流程连接您的Strava账号即可。之后AI助手就可以在获得您许可的情况下访问您的运动数据。

适用场景

当您希望AI助手基于您的运动数据提供个性化建议时特别有用，比如：分析跑步表现、制定训练计划、追踪健身进度或生成运动报告。

主要功能

Strava账号集成

使用行业标准的OAuth 2.1协议安全连接您的Strava账号，无需共享密码

数据隐私保护

所有运动数据都经过加密处理，您可以随时撤销访问权限

实时数据同步

通过SSE(服务器发送事件)技术保持数据实时更新

跨平台支持

兼容Claude Desktop、Cursor等多种AI客户端

优势

无需开发即可为AI应用添加Strava数据支持

基于Cloudflare Workers的全球分布式部署，低延迟

符合最新的OAuth 2.1安全标准

开源代码库，透明可信

局限性

依赖Strava API的速率限制(200次/15分钟)

需要基本的服务器部署知识

目前仅支持Strava平台

如何使用

注册Strava开发者应用

访问Strava开发者设置页面创建新应用，获取API密钥

部署MCP服务器

使用Wrangler CLI工具将服务器部署到Cloudflare Workers

配置AI客户端

在Claude Desktop等AI应用中添加服务器连接信息

完成OAuth授权

在AI应用中启动授权流程，登录Strava账号并授予权限

使用案例

训练分析

让AI分析您最近的跑步数据，提供表现评估和改进建议

活动摘要

自动生成月度运动摘要报告

常见问题

我的Strava密码会存储在服务器上吗？

如何撤销AI助手对我的Strava数据的访问权限？

服务器会存储我的运动数据吗？

为什么有时AI无法获取最新数据？

🚀 模型上下文协议（MCP）服务器 + Strava OAuth

本项目是一个基于模型上下文协议 (MCP)的服务器，支持远程 MCP 连接，并且内置了 Strava 的 OAuth 登录功能。用户可连接到您的 MCP 服务器，使用他们的 Strava 账户进行登录。

🚀 快速开始

克隆仓库

git clone https://github.com/kw510/strava-mcp.git
cd strava-mcp
npm install

设置 Strava API 凭证

生产环境

前往Strava 的 API 设置并创建一个新的应用。
配置您的应用程序：
- 应用程序名称：为您的应用程序选择一个名称
- 类别：选择适当的类别
- 网站：您的网站 URL
- 应用程序描述：简要描述您的应用程序
- 授权回调域名：mcp-strava-oauth.<your-subdomain>.workers.dev
- 授权回调 URL：https://mcp-strava-oauth.<your-subdomain>.workers.dev/callback
设置您的生产环境变量：

wrangler secret put STRAVA_CLIENT_ID
wrangler secret put STRAVA_CLIENT_SECRET

开发环境

前往Strava 的开发者控制台创建一个新的应用。
配置您的应用程序：
- 应用程序名称：例如 MCP - Dev
- 描述：简短描述，如 MCP Development App
- 网站 URL：http://localhost:3000
- 授权回调 URL：http://localhost:3000/login/callback

设置 Cloudflare KV 命名空间

wrangler kv:namespace create "OAUTH_KV"

使用生成的 KV ID 更新 wrangler.toml 文件。

部署到 Cloudflare

wrangler deploy

✨ 主要特性

OAuth 提供程序

使用 workers - oauth 库实现 OAuth 2.0 流程。
支持 Strava 的授权代码流。
配置回调 URL 和客户端 ID/密钥进行身份验证。

持久化 MCP

在 Cloudflare KV 存储中存储连接状态。
使用 durable - object 库管理持久化会话和用户数据。
实现安全的会话管理和状态存储。

MCP 代理

使用 @cloudflare/mcp - proxy 库创建 MCP 代理。
支持通过 WebSocket 和 HTTP 的双向通信。
提供对远程模型的访问，并处理请求和响应。

📦 安装指南

先决条件

拥有 Strava 账户
拥有 Cloudflare 账户
已安装 Node.js 和 npm
已安装 Wrangler CLI (npm install -g wrangler)

💻 使用示例

测试您的 MCP 服务器

使用 Inspector

安装并启动 Inspector。
打开 Inspector 的控制台。
创建一个新的 MCP 连接：

mcp create connection --name test - connection --url http://localhost:5000

启动连接：

mcp start - connection test - connection

在 Inspector 中，您应该看到来自 MCP 服务器的日志和消息。

使用 Claude Desktop

打开 Claude Desktop 并连接到您的 Cloudflare 账户。
导航至 Compute 标签并选择您的 MCP 应用。
在右侧控制台中，您可以与 MCP 代理交互：

mcp create connection --name test - connection --url http://localhost:5000
mcp start - connection test - connection

本地开发

克隆仓库并安装依赖项。
启动开发服务器：

npm run dev

打开浏览器访问 http://localhost:5000。

📚 详细文档

概述

MCP 服务器（由 Cloudflare Workers 提供支持）承担以下两种角色：

作为您的 MCP 客户端的 OAuth 服务提供商
作为 Strava 的 OAuth 服务的 OAuth 客户端

该项目作为一个参考示例，展示了如何将 OAuth 提供程序集成到部署在 Cloudflare 上的 MCP 服务器中，并使用 [workers - oauth - provider 库](https://github.com/cloudflare/workers - oauth - provider)。