Model Context Protocol (MCP) Server + Strava OAuth

1# Model Context Protocol (MCP) Server + Strava OAuth
2 
3This is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server that supports remote MCP connections, with Strava OAuth built-in. It allows users to connect to your MCP server by signing in with their Strava account.
4 
5## Overview
6 
7The MCP server (powered by [Cloudflare Workers](https://developers.cloudflare.com/workers/)) serves two roles:
8- Acts as an OAuth Server for your MCP clients
9- Acts as an OAuth Client for Strava's OAuth services
10 
11This project serves as a reference example for integrating OAuth providers with an MCP server deployed to Cloudflare, using the [`workers-oauth-provider` library](https://github.com/cloudflare/workers-oauth-provider).
12 
13## Prerequisites
14 
15- A Strava account
16- A Cloudflare account
17- Node.js and npm installed
18- Wrangler CLI installed (`npm install -g wrangler`)
19 
20## Quick Start
21 
221. Clone the repository:
23   ```bash
24   git clone https://github.com/kw510/strava-mcp.git
25   cd strava-mcp
26   npm install
27   ```
28 
292. Set up your Strava API credentials (see [Setting Up Strava API Credentials](#setting-up-strava-api-credentials))
30 
313. Set up your Cloudflare KV namespace:
32   ```bash
33   wrangler kv:namespace create "OAUTH_KV"
34   ```
35   Update the `wrangler.toml` file with the generated KV ID.
36 
374. Deploy to Cloudflare:
38   ```bash
39   wrangler deploy
40   ```
41 
42## Setting Up Strava API Credentials
43 
44### For Production
451. Go to [Strava's API Settings](https://www.strava.com/settings/api) and create a new application
462. Configure your application:
47   - Application Name: Choose a name for your application
48   - Category: Select an appropriate category
49   - Website: Your website URL
50   - Application Description: Brief description of your application
51   - Authorization Callback Domain: `mcp-strava-oauth.<your-subdomain>.workers.dev`
52   - Authorization Callback URL: `https://mcp-strava-oauth.<your-subdomain>.workers.dev/callback`
53 
543. Set your production environment variables:
55   ```bash
56   wrangler secret put STRAVA_CLIENT_ID
57   wrangler secret put STRAVA_CLIENT_SECRET
58   ```
59 
60### For Development
611. Create a separate Strava API application for development
622. Configure your development application:
63   - Authorization Callback Domain: `localhost`
64   - Authorization Callback URL: `http://localhost:8788/callback`
65 
663. Create a `.dev.vars` file in your project root:
67   ```
68   STRAVA_CLIENT_ID=your_development_strava_client_id
69   STRAVA_CLIENT_SECRET=your_development_strava_client_secret
70   ```
71 
72## Testing Your MCP Server
73 
74### Using Inspector
751. Install the Inspector tool:
76   ```bash
77   npx @modelcontextprotocol/inspector@latest
78   ```
79 
802. Connect to your server:
81   - For production: `https://mcp-strava-oauth.<your-subdomain>.workers.dev/sse`
82   - For development: `http://localhost:8788/sse`
83 
84### Using Claude Desktop
851. Open Claude Desktop and go to Settings -> Developer -> Edit Config
862. Add your MCP server configuration:
87   ```json
88   {
89     "mcpServers": {
90       "strava": {
91         "command": "npx",
92         "args": [
93           "mcp-remote",
94           "https://mcp-strava-oauth.<your-subdomain>.workers.dev/sse"
95         ]
96       }
97     }
98   }
99   ```
1003. Restart Claude Desktop and complete the OAuth flow
101 
102## Development
103 
104### Local Development
1051. Start the development server:
106   ```bash
107   wrangler dev
108   ```
109 
1102. The server will be available at `http://localhost:8788`
111 
112### API Rate Limits
113The Strava API has the following rate limits:
114- 200 requests every 15 minutes
115- 2,000 requests per day
116 
117## How It Works
118 
119### OAuth Provider
120The OAuth Provider library handles:
121- OAuth 2.1 server implementation
122- Token issuance and validation
123- Secure token storage in KV
124- Strava OAuth integration
125 
126### Durable MCP
127Provides:
128- Persistent state management
129- Secure authentication context storage
130- User information access via `this.props`
131- Conditional tool availability
132 
133### MCP Remote
134Enables:
135- Client-server communication
136- Tool definition and management
137- Request/response serialization
138- SSE connection maintenance
139 
140## Troubleshooting
141 
142- If you see error messages in Claude Desktop, verify the connection by hovering over the 🔨 icon
143- For Cursor integration, use the "Command" type and combine command and args into one string
144- Ensure your callback URLs match exactly with what's configured in your Strava application
145