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 Desktop を構成する: 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 : Strava 用の低レベル 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）