Rbctmz MCP Server Strava

🚀 Model Context Protocol (MCP) SDKを使用したStrava APIの統合

本プロジェクトでは、Model Context Protocol (MCP) SDKとStrava APIの統合方法について詳しく説明しています。以下の内容には、機能、要件、インストールガイド、設定手順、APIとサンプル、および開発に関する詳細情報が含まれています。

✨ 主な機能

• 運動データ分析：Stravaからデータを取得し、ユーザーのランニング、サイクリングなどの運動パフォーマンスを分析します。
• パフォーマンス追跡：過去のデータを統合して、長期的なフィットネスの進捗を追跡します。
• 個別化フィードバック：分析結果に基づいて、個別化されたトレーニング提案とフィードバックを提供します。

📦 インストール

インストール要件

環境構成

pip install mcp-sdk stravalib

クイックスタート

1. Stravaアプリを登録する：Strava開発者コンソールで新しいアプリを作成し、CLIENT_IDとCLIENT_SECRETを取得します。
2. 認証を行う：OAuth 2.0を使用してアクセストークンを取得します。

   from stravalib import Client
   
   client = Client()
   auth_url = client.authorization_url(client_id=STRAVA_CLIENT_ID, redirect_uri='http://localhost:8000/auth/callback')
   print(auth_url)
   

3. データを取得する：Strava APIからアクティビティデータを取得します。

   from mcp_sdk import MCPClient
   
   mcp = MCPClient()
   activities = mcp.get_activities()
   

📚 ドキュメント

設定ガイド

環境変数の設定

以下の内容を.envファイルに追加します。

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

セキュリティに関する注意事項

• データ暗号化：転送中の機密データを暗号化します。
• アクセス制御：ロールベースのアクセス制御（RBAC）を使用して、APIへのアクセスを制限します。

APIとサンプル

リソースの概要

サンプルコード

from stravalib import Client
from mcp_sdk import MCPClient

# Stravaクライアントを初期化する
strava_client = Client(access_token='your_access_token')

# アクティビティデータを取得する
activities = strava_client.get_activities()

# アクティビティデータを分析してレポートを生成する
mcp_client = MCPClient()
analysis_report = mcp_client.analyze_activities(activities)

開発ガイド

CI/CDとセキュリティ対策

• コードチェック：Ruffを使用してコードのフォーマットと品質を管理します。
• テストカバレッジ：テストカバレッジが要件を満たすことを確認します。

テストコマンド

ruff format .
ruff check .
pytest --cov=src

貢献ガイド

1. プロジェクトリポジトリをForkする
2. 依存関係をインストールする

   uv pip install -e ".[dev]"
   

3. 機能ブランチを作成する

   git checkout -b feature/name
   

4. 変更をコミットして、Pull Requestを作成します。

連絡先

• GitHub Issues：問題を作成する
• Telegram：@greg_kisel

📄 ライセンス

MIT