Model Context Protocol (mcp) Server + Strava Oauth

🚀 モデルコンテキストプロトコル（MCP）サーバー + Strava OAuth

このサーバーは、モデルコンテキストプロトコル (MCP) に基づいて構築されており、リモート MCP 接続をサポートし、Strava の OAuth ログイン機能が組み込まれています。ユーザーは、あなたの MCP サーバーに接続し、Strava アカウントでログインすることができます。

🚀 クイックスタート

前提条件

• 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
   

✨ 主な機能

OAuth プロバイダー

• workers-oauth ライブラリを使用して OAuth 2.0 フローを実装しています。
• Strava の認可コードフローをサポートしています。
• 認証のためにコールバック URL とクライアント ID/シークレットを設定します。

永続化 MCP

• Cloudflare KV ストレージに接続状態を保存します。
• durable-object ライブラリを使用して永続的なセッションとユーザーデータを管理します。
• セキュアなセッション管理と状態保存を実装しています。

MCP プロキシ

• @cloudflare/mcp-proxy ライブラリを使用して MCP プロキシを作成します。
• WebSocket と HTTP による双方向通信をサポートしています。
• リモートモデルへのアクセスを提供し、リクエストとレスポンスを処理します。

📦 インストール

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 の開発者コンソールにアクセスし、新しいアプリケーションを作成します。
2. アプリケーションを構成します：
   • アプリケーション名：例えば MCP-Dev
   • 説明：MCP Development App のような簡単な説明
   • ウェブサイト URL：http://localhost:3000
   • 認可コールバック URL：http://localhost:3000/login/callback

💻 使用例

Inspector を使用する場合

1. Inspector をインストールして起動します。
2. Inspector のコンソールを開きます。
3. 新しい MCP 接続を作成します：

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

4. 接続を開始します：

   mcp start-connection test-connection
   

5. Inspector で、MCP サーバーからのログとメッセージが表示されるはずです。

Claude Desktop を使用する場合

1. Claude Desktop を開き、Cloudflare アカウントに接続します。
2. Compute タブに移動し、あなたの MCP アプリを選択します。
3. 右側のコンソールで、MCP プロキシと対話できます：

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

📚 ドキュメント

開発

ローカル開発

1. リポジトリをクローンし、依存関係をインストールします。
2. 開発サーバーを起動します：

   npm run dev
   

3. ブラウザを開き、http://localhost:5000 にアクセスします。

API レート制限

• Strava の無料プランでは、1 時間あたり 18,000 回の呼び出し制限があります。
• 制限を超えると、リクエストが拒否されたり、遅延が発生したりする可能性があります。

🔧 技術詳細

MCP サーバー（Cloudflare Workers によってサポートされています）は、以下の 2 つの役割を果たします：

• あなたの MCP クライアントの OAuth サービスプロバイダーとして
• Strava の OAuth サービスの OAuth クライアントとして

このプロジェクトは、OAuth プロバイダーを Cloudflare 上にデプロイされた MCP サーバーに統合する方法を示す参考例であり、workers-oauth-provider ライブラリ を使用しています。

注意事項

⚠️ 重要提示

• すべてのコールバック URL が正しく構成され、Strava アプリケーションの設定と完全に一致していることを確認してください。
• API 呼び出し制限を定期的に確認し、クォータを超えないようにしてください。
• 本番環境では、セキュリティを確保するために HTTPS を使用し、SSL 証明書を設定してください。
• クライアント ID やシークレットなどの機密情報は、環境変数を使用して管理してください。

以上の手順に従うことで、Strava ログインをサポートする MCP サーバーを正常にデプロイして実行し、Cloudflare の強力な機能を利用して拡張および最適化することができます。