On Running MCP

关于运行MCP

用于与运行中的网站API交互的模型内容协议（MCP）服务器。

概述

该项目通过FastMCP服务器提供了一个到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：使用可选筛选器对正在运行的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：运行API客户端时 - schemas.py：API数据的Pydantic模型