On Running MCP

🚀 On Running MCPの実行について

On Running MCPは、On RunningウェブサイトのAPIとやり取りするためのModel-Context-Protocol（MCP）サーバーです。このプロジェクトは、FastMCPサーバーを介してOn Runningウェブサイトの製品データにアクセスするためのインターフェースを提供します。

🚀 クイックスタート

On Running MCPは、FastMCPサーバーを通じてOn Runningウェブサイトの製品データにアクセスするためのインターフェースを提供します。以下のことが可能です。

• 様々なフィルターを使用してOn Running APIをクエリする
• 製品名、画像、アクティビティなどの製品情報を取得する
• タイプ、サブタイプ、性別で製品を絞り込む

📦 インストール

Python 3.12以上が必要です。

# リポジトリをクローンする
git clone https://github.com/yourusername/on-running-mcp.git
cd on-running-mcp

# 仮想環境を作成してアクティブ化する（オプションだが推奨）
uv venv

# 依存関係を同期する
uv sync

💻 使用例

Claudeデスクトップにサーバー設定を追加する

cd on_running_mcp
uv run mcp install server.py

利用可能なツール

MCPサーバーは以下のツールを提供します。

• make_query：オプションのフィルターを使用してOn Running APIにクエリを送信する
• get_product_names：結果からすべての製品名を取得する
• get_activities：各製品に関連付けられたアクティビティを取得する
• filter_by_product_name：名前で特定の製品を検索する
• get_product_image：特定の製品の画像を取得する
• get_product_type_options：利用可能な製品タイプ（靴、服装、アクセサリー）をリストする
• get_product_subtype_options：利用可能な製品サブタイプ（上着、ショートパンツなど）をリストする
• get_gender_options：利用可能な性別オプション（男性用、女性用、子供用）をリストする

基本的な使用法

# 例：次の月にマラソンに参加する予定で、ランニングに適した靴下を探しています。