AI导哈

跑步产品API接口服务

一个通过FastMCP服务器与On Running网站API交互的服务，提供产品查询、过滤和获取产品信息的功能。

  • by scott-clare1
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 scott-clare1/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模型

相关 MCP