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缓存，以保持在限制范围内。