On Running MCP

Name: On Running MCP
Author: scott-clare1

@scott-clare1

リポジトリ

On Running MCP について

An MCP server for interacting with the On Running API

#on-running #mcp #api-interaction

基本情報

カテゴリ

その他

ランタイム

python

トランスポート

stdio

公開者

scott-clare1

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "on-running-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

ツール

Make a query to the On Running API with optional filters

Get all product names from the results

Get activities associated with each product

Find a specific product by name

Get an image for a specific product

List available product types (shoes, apparel, accessories)

List available product subtypes (tops, shorts, etc.)

List available gender options (men's, women's, kids)

概要

What is On Running MCP?

On Running MCP is a Model Context Protocol server that provides an interface to the On Running website’s product data through a FastMCP server. It allows AI agents to query products, retrieve names, images, and activities, and filter by type, subtype, and gender.

How to use On Running MCP?

Installation requires Python 3.12+ and uv. Clone the repository, create a virtual environment with uv venv, then run uv sync. Add the server to Claude Desktop by running uv run mcp install server.py from the on_running_mcp directory. Use the available tools to query and filter product data.

Key features of On Running MCP

Query the On Running API with optional filters.
Get all product names from query results.
Retrieve activities associated with each product.
Filter products by name with filter_by_product_name.
Get an image for a specific product.
List product types, subtypes, and gender options.

Use cases of On Running MCP

Find running shoes or apparel for a specific event (e.g., marathon socks).
Browse products filtered by gender (men's, women's, kids).
Retrieve product images for visual recommendations.
List available product types and subtypes to guide queries.
Narrow down products by name for precise matches.

FAQ from On Running MCP

What does On Running MCP do?

It acts as a bridge between AI assistants and the On Running website API, enabling natural‑language queries to fetch product data with filters.

What are the system requirements?

You need Python 3.12 or newer and the uv package manager.

How do I install On Running MCP?

Clone the repository, create a virtual environment with uv venv, run uv sync to install dependencies, then execute uv run mcp install server.py to register the server with Claude Desktop.

What filters are available?

You can filter by product type (shoes, apparel, accessories), subtype (tops, shorts, etc.), and gender (men’s, women’s, kids). Use the corresponding tool options to see valid values.

How can I get product images?

Use the get_product_image tool to retrieve an image for a specific product after querying the API.

「その他」の他のコンテンツ

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K