On Running MCP

On Running について

On Running ウェブサイトの API と連携する Model-Context-Protocol（MCP）サーバーです。

概要

このプロジェクトは、FastMCP サーバーを通じて On Running ウェブサイトの商品データにアクセスするためのインターフェースを提供します。次のことができます。

• さまざまなフィルターを使って On Running API にクエリを送信する
• 商品名、画像、アクティビティなどの商品情報を取得する
• タイプ、サブタイプ、性別で商品を絞り込む

インストール

Python 3.12 以降が必要です。

# Clone the repository
git clone https://github.com/yourusername/on-running-mcp.git
cd on-running-mcp

# Create and activate a virtual environment (optional but recommended)
uv venv

# Sync the dependencies
uv sync

使い方

Claude Desktop にサーバー設定を追加する

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：利用可能な性別の選択肢（男性用、女性用、子ども用）を一覧表示します

使用例

今月末にマラソンを走る予定です。ランニング用のソックスを見つけるのを手伝ってもらえますか？

プロジェクト構成

• on_running_mcp/：メインのパッケージディレクトリ
  • server.py：ツール定義を含む MCP サーバーの実装
  • core/：API の中核となる実装
    • api.py：On Running API クライアント
    • schemas.py：API データ用の Pydantic モデル