odds-api-mcp-server

Odds-API.io MCP 服务

适用于 Odds-API.io 的 Model Context Protocol（MCP）服务，为 Claude、Cursor 和 VS Code 等 AI 工具提供体育博彩赔率数据的直接访问权限。

完整的 AI 工具文档：docs.odds-api.io/ai-vibe-coding

功能

• 25 个 API 工具，覆盖完整的 Odds-API.io v3 功能：体育项目、赛事、赔率、历史数据、投注结算、价值投注、套利、赔率下跌等
• 文档资源，为 AI 提供上下文
• 实时数据，涵盖 34 项体育运动中的 450 多家博彩公司

快速开始

一键安装（Claude Desktop）

从 Releases 下载最新的 .mcpb 文件并打开。Claude Desktop 会提示你输入 API 密钥。

Claude Code CLI

claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

Claude Desktop

添加到 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 上为 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

添加到 Cursor MCP 设置（项目中的 .cursor/mcp.json 或全局配置）：

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

添加到 VS Code 设置（.vscode/mcp.json）：

{
  "servers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

全局安装（替代方式）

npm install -g odds-api-mcp-server

然后使用 odds-api-mcp 作为命令，而不是 npx -y odds-api-mcp-server。

配置

变量	必填	说明
ODDS_API_KEY	是	你的 API 密钥，来自 odds-api.io

可用工具

体育项目与联赛

工具	说明
get_sports	列出所有可用体育项目及其 slug
get_leagues	获取某项体育运动的联赛（可选使用 all 标志，包含未激活的联赛）
get_markets	列出某项体育运动提供的准确市场名称，以及其类型、赛段和赛前／滚球可用情况

博彩公司

工具	说明
get_bookmakers	列出所有受支持的博彩公司
get_selected_bookmakers	获取当前已选博彩公司
select_bookmakers	将博彩公司添加到你的选择中
clear_selected_bookmakers	清除所有已选博彩公司（每 12 小时一次）

赛事

工具	说明
get_events	获取赛事并进行筛选（联赛、状态、日期范围、参赛方、博彩公司、分页）
get_event	按 ID 获取单场赛事
get_live_events	获取当前正在进行的赛事
search_events	按队名或文本搜索赛事

赔率

工具	说明
get_odds	获取所选博彩公司提供的某场赛事赔率
get_multi_odds	一次调用获取最多 10 场赛事的赔率
get_odds_movements	获取某个市场的历史赔率变动
get_updated_odds	获取近期变动的赔率（轮询），适用于你指定的市场

历史数据

工具	说明
get_historical_events	获取指定体育项目／联赛／日期范围内已结束的赛事
get_historical_odds	获取已结束赛事的收盘赔率和比分

博彩分析

工具	说明
get_settlements	获取最多 50 场赛事的状态、最终比分和 final 标志
grade_bets	将最多 50 笔投注结算为赢、输、作废、半赢或半输
get_value_bets	获取某家博彩公司提供的正期望值机会
get_arbitrage_bets	获取附带最优投注额的套利机会
get_dropping_odds	按体育项目、联赛、市场和时间窗口追踪专业博彩公司赔率变动

参赛方

工具	说明
get_participants	获取某项体育运动的队伍／参赛方
get_participant	按 ID 获取单个参赛方

参考

工具	描述
get_documentation	获取完整的 API 文档

资源

资源 URI	描述
odds-api://documentation	完整的 API 文档
odds-api://openapi	OpenAPI/Swagger 规范

示例用法

配置完成后，可以向 AI 助手提出以下问题：

• “Odds-API 上有哪些体育项目？”
• “显示即将举行的英超联赛比赛”
• “获取下一场 Arsenal 比赛在 Bet365 和 SingBet 的赔率”
• “查找 Bet365 上包含赛事详情的价值投注”
• “Bet365 和 Unibet 之间有套利机会吗？”
• “显示事件 12345 在让分市场的赔率变动情况”
• “获取 2026 年 1 月西甲联赛的历史赛果”
• “显示目前足球赛事中下降幅度最大的赔率”
• “过去 12 小时内，哪些英超赔率降幅最大？”

开发

git clone https://github.com/odds-api-io/odds-api-mcp-server
cd odds-api-mcp-server
npm install
npm run build
npm test

许可证

MIT

链接

• Odds-API.io - 主网站
• 文档 - API 文档
• API 参考 - Swagger/OpenAPI
• npm - 软件包注册表