Ctvidic Strava MCP Server

🚀 Strava MCP サーバー

Strava API へのアクセスを提供する Model Context Protocol (MCP) サーバーです。このサーバーを使用すると、言語モデルが Strava のデータ（アクティビティやアスリート情報など）とやり取りできます。

🚀 クイックスタート

Strava MCP サーバーを使用することで、言語モデルが Strava API と連携し、アクティビティやアスリート情報などのデータを取得できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 🏃♂️ アクティビティの追跡と分析
• 📊 アスリートの統計データ
• 🗺️ ルートの可視化
• 🏆 実績の追跡
• 🤝 ソーシャル機能（いいね、コメント）

📦 インストール

前提条件

• Python 3.12+
• Strava API の認証情報
• pip（Python パッケージ管理ツール）

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/yourusername/strava_mcp.git
cd strava_mcp

2. 仮想環境を作成します。

python -m venv venv
source venv/bin/activate  # Windowsの場合は .\venv\Scripts\activate

3. 依存関係をインストールします。

pip install -r requirements.txt

📚 ドキュメント

設定

1. config/.env ファイルを作成し、Strava API の認証情報を追加します。

STRAVA_CLIENT_ID=your_client_id
STRAVA_CLIENT_SECRET=your_client_secret
STRAVA_REFRESH_TOKEN=your_refresh_token

2. Strava API の認証情報を取得する方法：
   • https://www.strava.com/settings/api にアクセスします。
   • 新しいアプリケーションを作成します。
   • クライアント ID とクライアントシークレットを記録します。
   • OAuth 2.0 を使用してアクセストークンを取得します。

使用方法

基本的な使用法

MCP サーバーとして使用する場合

1. Strava 接続を初期化します。

from strava_mcp_server import connect_to_strava
connection = connect_to_strava("path/to/credentials.json")

2. Strava にクエリを送信します。

response = connection.send_query("获取最近活动")
print(response)

HTTP サーバーとして使用する場合

1. サーバーを起動します。

python -m strava_mcp_server --port 5000

2. API エンドポイントを呼び出します。

curl http://localhost:5000/api/recent_activities

開発に関する情報

プロジェクト構造

• strava_mcp_server/: サーバーの実装と関連モジュールが含まれています。
• config/: .env などの設定ファイルが保存されています。

貢献ガイド

1. リポジトリをフォークします。

git clone https://github.com/yourusername/strava_mcp.git

2. 機能ブランチを作成します。

git checkout -b feature/new_functionality

3. 変更をコミットします。

git add .
git commit -m "添加新功能"
git push origin feature/new_functionality

4. プルリクエストを作成します。

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

• .env や API の認証情報などの機密情報を含むファイルをコミットしないでください。
• .gitignore で設定されており、機密データがバージョン管理システムにコミットされるのを防いでいます。
• すべての機密設定情報は環境変数を使用して管理してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。

謝辞

以下のリソースとサポートに感謝します。

• Strava API ドキュメント
• Model Context Protocol (MCP) 仕様
• すべての貢献者とメンテナー