on-running-mcp

🚀 关于On Running MCP

一个用于与On Running网站API交互的Model-Context-Protocol（MCP）服务器，能够方便快捷地访问On Running网站的产品数据。

🚀 快速开始

此项目提供了一个接口，通过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：列出可用的性别选项（男款、女款、儿童）

示例用法

例如，当您说出“我计划下个月参加一场马拉松，你能帮我找一双适合跑步的袜子吗？”时，就可以借助上述工具来筛选出合适的产品。