On Running MCP

一个用于与 On Running 网站 API 交互的 Model-Context-Protocol (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 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 模型