Sports Betting Mcp

sports-betting-mcp

首个体育博彩 MCP 服务。 让任何 AI Agent 都能实时获取 NBA、NHL、NCAAB 和 MLB 的推荐、赔率、比赛分析及表现追踪数据。

mcp-name: io.github.seang1121/sports-betting-mcp

---

功能介绍

将任何兼容 MCP 的 AI Agent 连接到实时体育博彩分析系统。每条推荐都会在比赛开始前记录，并根据最终比分结算。绝不挑选有利结果。

指标	数值
覆盖体育项目	NBA、NHL、NCAAB、MLB
投注类型	独赢盘、让分盘、大小盘
推荐来源	12-Agent 共识模型
推荐总数	已结算 3,859+ 条
平台用户	30
工具	12 个 MCP 工具
身份验证	API 密钥（X-API-Key 标头）

各体育项目的结果

体育项目	推荐数	获胜数	胜率
NBA	1,267	762	60.1%
NHL	1,148	656	57.1%
NCAAB	1,149	549	47.8%
MLB	283	109	38.5% (于 2026 年 4 月上线)

所有结果都可通过 get_win_rate 工具实时查询。每场比赛结束后都会更新数据。

---

快速开始

安装

pip install sports-betting-mcp

添加到 MCP 客户端

将以下内容添加到 MCP 配置中（Claude Desktop、Cursor、Windsurf、Claude Code 等）：

{
  "mcpServers": {
    "sports-betting": {
      "command": "sports-betting-mcp",
      "env": {
        "SPORTS_BETTING_API_URL": "https://sportsbettingaianalyzer.com",
        "SPORTS_BETTING_API_KEY": "your_api_key"
      }
    }
  }
}

环境变量

变量	必需	说明
SPORTS_BETTING_API_KEY	是	用于身份验证的 API 密钥
SPORTS_BETTING_API_URL	否	API 基础 URL（默认为 http://localhost:5000）

---

兼容平台

任何支持 Model Context Protocol 的客户端：

客户端	状态
Claude Desktop	完全支持
Cursor	完全支持
Windsurf	完全支持
Claude Code (CLI)	完全支持
任何 MCP 客户端	通过 stdio 传输完全支持

---

可用工具

共 12 个工具。每次调用都会返回结构化数据，供 AI Agent 分析、展示或用于执行操作。

推荐与分析

工具	功能
get_todays_picks	获取所有 AI 推荐，包含信心评分和优势分析；可按体育项目筛选
get_top_pick	获取当天信心度最高的一条推荐
get_pending_picks	获取当前尚未结算、比赛仍在进行中的推荐
get_completed_picks	获取近期已结算并附有胜负结果的推荐，用于核验历史表现
analyze_game	获取任意比赛的完整 12-Agent 分析：共识推荐和优势分析

赔率与市场数据

工具	功能
get_live_odds	获取当天比赛的实时独赢盘、让分盘和大小盘赔率
get_alerts	获取多 Agent 系统发出的有效提醒（盘口变动、伤病影响）

表现与统计数据

工具	功能
get_win_rate	获取胜率，并按体育项目和投注类型细分
get_model_stats	查看模型表现：推荐总数、最近 20 条推荐的胜率、信心度等级分布
get_leaderboard	按胜率查看用户排名
get_system_status	健康检查：运行时长、数据库和调度器状态

---

分析原理

每场比赛都会经过一个多 Agent 流程：

1. 12 个专门的 Agent 独立评估比赛，涵盖势头、对阵情况、伤病、休息、旅途、公众投注比例、专业资金指标、历史趋势等。
2. 共识引擎 综合全部 12 个观点，给出一个投注选择和信心评分。
3. 优势值计算 将模型的隐含概率与当前市场盘口进行比较。
4. 记录投注选择，并在开赛前保存，之后根据最终比分判定结果。不进行追溯性编辑。

每个投注选择的响应中都包含信心评分和优势值明细，因此你的 AI Agent 可以筛选、排序或解释任何建议背后的依据。

---

完整 API — 22 个端点

API 分为两个层级：免费版（任意 API 密钥均可使用）和 专业版（需获批访问）。

免费版（所有 API 密钥持有者均可使用）

端点	方法	功能
/xk/p	GET	今日 AI 投注建议及信心评分
/xk/o/{sport}	GET	FanDuel/BetMGM 的实时赔率
/xk/w	GET	按体育项目和投注类型划分的胜率明细
/xk/i	GET	Covers.com 提供的最新伤病报告
/xk/m	GET	显著的盘口变动（专业资金信号）
/xk/games	GET	今日完整赛程，含赔率快照和 AI 投注建议标记
/xk/stats	GET	按体育项目、投注类型和信心等级划分的模型表现
/xk/lb	GET	排行榜 — AI 与人类的胜率对比
/xk/news	GET	来自 RSS 来源的体育新闻动态
/xk/q	GET	当前待定（未判定）的投注选择

专业版（需获批访问）

端点	方法	功能
/xk/full	GET	完整的结构化投注选择 — 完整的优势值明细、正负优势、依据、评分卡、含赔率的对立方、盘口变动、质量标记
/xk/analyze	POST	按需分析任意比赛，使用 12 个 Agent — 提交球队名称，获取完整共识结果
/xk/results	GET	已判定的投注选择，含 W/L、实际比分、收益和主要优势贡献项
/xk/clv	GET	收盘盘口价值分析 — 盘口变动是否有利于我们？
/xk/search	GET	按球队名称搜索所有投注选择及其 W/L 记录
/xk/log	POST	记录投注选择（支持 flip 标记和投注选择来源追踪）
/xk/log/batch	POST	批量记录最多 20 项投注选择，并为每项返回成功/重复/错误状态
/xk/history	GET	你的投注选择历史 — 待定、已判定、胜率
/xk/slip	POST	生成 Nimrod 投注单图片
/xk/webhook	POST/GET/DELETE	为投注选择事件注册 webhook
/xk/full	GET	包含每项投注选择的 fade/flip 数据 — 对立方、盘口、赔率

专业版投注选择数据

/xk/full 中的每项投注选择都包含：

{
  "ai_pick": "Lakers -5.5",
  "ai_verdict": "STRONG BET",
  "ai_probability": "65%",
  "ai_reasoning": "Lakers defense ranks top 5, opponent on B2B...",
  "edges": [13 individual edge factors],
  "top_edges": [top 5 positive],
  "negative_edges": [top 3 negative],
  "scorecard": [3 model scores],
  "fade_pick": "Celtics +5.5",
  "fade_team": "Celtics",
  "fade_odds": "+105",
  "fade_note": "Betting AGAINST the AI — take Celtics +5.5",
  "line_moved": true,
  "flags": ["line_moved"],
  "data_quality": "good"
}

投注选择来源追踪（用于学习）

记录投注选择时，加入 pick_source 以追踪决策类型：

• model_agree — 跟随 AI 的投注选择
• flip — 反向操作／对 AI 的建议下注
• manual_override — 自定义投注选择

这样便可随时间比较跟随模型与反向投注选择的胜率。

---

API 身份验证

使用 X-API-Key 标头进行身份验证。在 sportsbettingaianalyzer.com 获取免费密钥。专业版访问权限需经管理员批准。

---

技术栈

组件	技术
运行时	Python 3.10+
协议	MCP (Model Context Protocol)
传输方式	stdio
构建工具	Hatchling
分发渠道	PyPI (sports-betting-mcp)
后端	Flask + SQLite
分析	12 Agent 共识流程
体育项目	NBA、NHL、NCAAB、MLB

---

相关项目

• Mortgage Rates MCP Server -- 17 家贷款机构、13 个工具，实时抵押贷款利率情报
• March Madness Bracket Predictor -- 5 模型集成、14 年回测、77% 准确率，正确预测了 2026 年冠军
• Agent Command Center -- 可自动发现 MCP 服务、Agent、钩子、cron 作业和代码库的仪表板

许可证

MIT