on-running-mcp

on-running-mcp

0
entertainment_and_media

The project is a Model-Context-Protocol server that interfaces with the On Running website to provide access to product data via an API. It allows users to query and filter product information using various parameters.

On Running MCP

A Model-Context-Protocol (MCP) server for interacting with the On Running website API.

Overview

This project provides an interface to the On Running website's product data through a FastMCP server. It allows you to:

  • Query the On Running API with various filters
  • Get product information including names, images, and activities
  • Filter products by type, subtype, and gender

Installation

Requires 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

Usage

Add the Server Config to Claude Desktop.

cd on_running_mcp
uv run mcp install server.py

Available Tools

The MCP server provides the following tools:

  • make_query: Make a query to the On Running API with optional filters
  • get_product_names: Get all product names from the results
  • get_activities: Get activities associated with each product
  • filter_by_product_name: Find a specific product by name
  • get_product_image: Get an image for a specific product
  • get_product_type_options: List available product types (shoes, apparel, accessories)
  • get_product_subtype_options: List available product subtypes (tops, shorts, etc.)
  • get_gender_options: List available gender options (men's, women's, kids)

Example Usage

I am running a marathon later this month, can you help me to find a pair of socks for running in?

Project Structure

  • on_running_mcp/: Main package directory
    • server.py: MCP server implementation with tool definitions
    • core/: Core API implementation
      • api.py: On Running API client
      • schemas.py: Pydantic models for API data