AI导哈

赛马数据API服务

一个连接Claude和其他LLM的赛马数据API服务，提供实时赛马数据、统计和分析。

  • by mohsinm-dev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mohsinm-dev/racing-mcp-server

使用说明

赛车API MCP服务器

一个模型上下文协议（MCP）服务器，将Claude和其他LLM连接到 赛马API（theracingapi.com）为他们提供了对赛马数据的实时访问， 统计和分析。

特性

  • 完整实体解析（名称→ ID）用于马匹、骑师、驯马师、主人、公公、水坝
  • 赛车卡（今天的比赛，即将到来的赛程）
  • 比赛结果（历史记录，可按目的地/级别/距离/地区过滤）
  • 统计分析（胜率、A/E比、按班级/距离/课程划分的损益）
  • 育种分析（父系/母系/父系后代统计数据）
  • 自动收卷机→ 码转换
  • 内置缓存（基于TTL）以遵守速率限制
  • 支持stdio（本地/Claude桌面）和HTTP/SSE（远程/托管）传输

需求

  • Python 3.11+
  • API赛车订阅（推荐最低标准计划）
  • uv 包管理器（推荐）或 pip

安装

# Clone the repo
git clone https://github.com/mohsinm-dev/racing-mcp-server
cd racing-mcp-server

# Install with uv (recommended)
uv sync

# Or with pip
pip install -e .

配置

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

RACING_API_USERNAME=your_username
RACING_API_PASSWORD=your_password
RACING_API_BASE_URL=https://api.theracingapi.com/v1

跑步

stdio模式（适用于克劳德桌面）

python -m racing_mcp.server

HTTP/SSE模式（用于托管/远程使用）

python -m racing_mcp.server --transport sse --host 0.0.0.0 --port 8080

直接用uvicorn

uvicorn racing_mcp.http_server:app --host 0.0.0.0 --port 8080

Claude桌面集成

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "racing-api": {
      "command": "python",
      "args": ["-m", "racing_mcp.server"],
      "cwd": "/path/to/racing-mcp-server",
      "env": {
        "RACING_API_USERNAME": "your_username",
        "RACING_API_PASSWORD": "your_password"
      }
    }
  }
}

可用工具

参考数据

  • get_regions --列出所有地区代码（gb、ire、fr、hk、usa等）
  • get_courses --列出所有带有ID的课程，可选择按地区筛选

搜索/实体解析

  • search_horse --按名称查找马→ 返回horse_id
  • search_jockey --按名字查找骑师→ 返回骑师id
  • search_trainer --按姓名查找培训师→ 返回trainer_id
  • search_owner --按名称查找所有者→ 返回owner_id
  • search_sire --按名字查找陛下→ 返回sire_id
  • search_dam --按名称查找大坝→ 返回dam_id

赛车卡和成绩

  • get_racecards --今天/即将到来的比赛卡片，包括参赛者、赔率、表格
  • get_results --按日期/赛道/地区/比赛/级别筛选的比赛结果
  • get_race --按race_id列出的单场比赛详细结果

马分析

  • get_horse_results --马的完整历史结果
  • get_horse_analysis_classes --按种族分类的表现
  • get_horse_analysis_distances --按距离划分的性能
  • get_horse_analysis_going --按行驶条件划分的性能
  • get_horse_analysis_courses --按课程分列的业绩

骑师分析

  • get_jockey_results --完整的历史游乐设施
  • get_jockey_analysis_classes --按种族分类
  • get_jockey_analysis_distances --按距离
  • get_jockey_analysis_going --通过去
  • get_jockey_analysis_courses --当然
  • get_jockey_analysis_trainers --赛马/教练伙伴关系
  • get_jockey_analysis_owners --骑师/车主细分

培训师分析

  • get_trainer_results --完整的历史结果
  • get_trainer_analysis_classes --按班级
  • get_trainer_analysis_distances --按距离
  • get_trainer_analysis_going --通过去
  • get_trainer_analysis_courses --当然
  • get_trainer_analysis_jockeys --教练/骑师伙伴关系

所有者分析

  • get_owner_results --所有者马匹的所有比赛
  • get_owner_analysis_classes --按班级
  • get_owner_analysis_trainers --所有者/培训师故障

育种分析

  • get_sire_results --陛下后代结果
  • get_sire_analysis_distances --按距离划分的陛下后代
  • get_sire_analysis_classes --按阶级划分的陛下后代
  • get_dam_results --大坝子代结果
  • get_dam_analysis_distances --按距离划分的大坝后代

计划要求

工具组 最小计划
课程，地区 免费
赛车卡（基本） 基本
结果，马/赛马/训练师分析 标准
完整的历史结果，育种 专业版

速率限制

API赛车强制执行5请求/秒（球场/地区为1请求/秒）。 此服务器包括自动速率限制和TTL缓存，以保持在限制范围内。

相关 MCP