Model Context Protocol (MCP) Server + Strava OAuth

Model Context Protocol (MCP) Server + Strava OAuth

一个基于 Cloudflare Workers 构建的、集成了 Strava OAuth 的模型上下文协议 (MCP) 服务器。它通过 Strava 登录,为 Claude 和 Cursor 等 MCP 客户端提供安全的身份验证和工具访问。对于希望将 Strava 身份验证与 AI 工具集成的开发者来说,这是一个完美的解决方案。

kw510

开发者工具
访问服务器

README

模型上下文协议 (MCP) 服务器 + Strava OAuth

这是一个支持远程 MCP 连接的 模型上下文协议 (MCP) 服务器,内置 Strava OAuth。它允许用户通过使用他们的 Strava 帐户登录来连接到您的 MCP 服务器。

概述

MCP 服务器(由 Cloudflare Workers 提供支持)承担两个角色:

  • 充当您的 MCP 客户端的 OAuth 服务器
  • 充当 Strava OAuth 服务的 OAuth 客户端

本项目是一个参考示例,展示了如何使用 workers-oauth-provider 将 OAuth 提供程序与部署到 Cloudflare 的 MCP 服务器集成。

前提条件

  • 一个 Strava 帐户
  • 一个 Cloudflare 帐户
  • 已安装 Node.js 和 npm
  • 已安装 Wrangler CLI (npm install -g wrangler)

快速开始

  1. 克隆存储库:

    git clone https://github.com/kw510/strava-mcp.git
    cd strava-mcp
    npm install
    
  2. 设置您的 Strava API 凭据(请参阅 设置 Strava API 凭据

  3. 设置您的 Cloudflare KV 命名空间:

    wrangler kv:namespace create "OAUTH_KV"
    

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

  4. 部署到 Cloudflare:

    wrangler deploy
    

设置 Strava API 凭据

用于生产环境

  1. 转到 Strava 的 API 设置 并创建一个新应用程序

  2. 配置您的应用程序:

    • 应用程序名称:为您的应用程序选择一个名称
    • 类别:选择一个合适的类别
    • 网站:您的网站 URL
    • 应用程序描述:您的应用程序的简要描述
    • 授权回调域:mcp-strava-oauth.<your-subdomain>.workers.dev
    • 授权回调 URL:https://mcp-strava-oauth.<your-subdomain>.workers.dev/callback
  3. 设置您的生产环境变量:

    wrangler secret put STRAVA_CLIENT_ID
    wrangler secret put STRAVA_CLIENT_SECRET
    

用于开发环境

  1. 为开发创建一个单独的 Strava API 应用程序

  2. 配置您的开发应用程序:

    • 授权回调域:localhost
    • 授权回调 URL:http://localhost:8788/callback
  3. 在您的项目根目录中创建一个 .dev.vars 文件:

    STRAVA_CLIENT_ID=your_development_strava_client_id
    STRAVA_CLIENT_SECRET=your_development_strava_client_secret
    

测试您的 MCP 服务器

使用 Inspector

  1. 安装 Inspector 工具:

    npx @modelcontextprotocol/inspector@latest
    
  2. 连接到您的服务器:

    • 用于生产环境:https://mcp-strava-oauth.<your-subdomain>.workers.dev/sse
    • 用于开发环境:http://localhost:8788/sse

使用 Claude Desktop

  1. 打开 Claude Desktop 并转到 Settings -> Developer -> Edit Config
  2. 添加您的 MCP 服务器配置:
    {
      "mcpServers": {
        "strava": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp-strava-oauth.<your-subdomain>.workers.dev/sse"
          ]
        }
      }
    }
    
  3. 重新启动 Claude Desktop 并完成 OAuth 流程

开发

本地开发

  1. 启动开发服务器:

    wrangler dev
    
  2. 服务器将在 http://localhost:8788 上可用

API 速率限制

Strava API 具有以下速率限制:

  • 每 15 分钟 200 个请求
  • 每天 2,000 个请求

工作原理

OAuth 提供程序

OAuth 提供程序库处理:

  • OAuth 2.1 服务器实现
  • 令牌颁发和验证
  • KV 中的安全令牌存储
  • Strava OAuth 集成

持久 MCP

提供:

  • 持久状态管理
  • 安全的身份验证上下文存储
  • 通过 this.props 访问用户信息
  • 有条件的工具可用性

MCP Remote

启用:

  • 客户端-服务器通信
  • 工具定义和管理
  • 请求/响应序列化
  • SSE 连接维护

故障排除

  • 如果您在 Claude Desktop 中看到错误消息,请通过将鼠标悬停在 🔨 图标上来验证连接
  • 对于 Cursor 集成,请使用“Command”类型并将命令和参数合并为一个字符串
  • 确保您的回调 URL 与 Strava 应用程序中配置的完全匹配

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。

官方
本地
JavaScript