mcp-odds-api

基本能力

产品定位

mcp-odds-api 是一个用于获取体育赛事赔率信息的 MCP 服务器，适用于需要实时或即将举行的体育赛事赔率数据的场景。

核心功能

• 使用环境变量限制查询的区域和体育项目。
• 支持 SSE 和 STDIO 传输方式。
• 提供以下工具：
• get_events: 获取进行中和即将举行的赛事（比赛）。
• get_odds: 获取所有即将举行的赛事的赔率信息。
• get_event_odds: 获取特定赛事的赔率信息。

适用场景

• 体育博彩数据分析
• 实时赛事赔率监控
• 体育赛事赔率历史数据收集

工具列表

• get_events: 获取赛事列表。
• get_odds: 获取赛事赔率。
• get_event_odds: 获取特定赛事赔率。

常见问题解答

• 如何配置环境变量？
• 创建或编辑 Claude Desktop 配置文件，添加相应的环境变量。
• 如何启动服务器？
• 使用 uvx 或 uv 命令启动服务器，指定传输方式和端口。

使用教程

使用依赖

1. Prerequisites:
2. Python 3.10 或更高版本。
3. OddsAPI 密钥（申请地址）。
4. uv 包管理器（安装指南）。

安装教程

1. 克隆仓库:

git clone https://github.com/marcoeg/mcp-odds-api
cd mcp-nvd

1. 设置环境变量:

2. 在项目根目录创建 .env 文件： ODDS_API_KEY="<your-api-odds-key>" ODDS_API_REGIONS="<region1>", "<region2>" ODDS_API_SPORT="<selected-sport-key>"

3. 安装依赖:

uv sync
uv pip install -e .

调试方式

1. 启动服务器:

$ uv run mcp-odds-api --transport sse --port 9090

1. 运行检查器:

$ CLIENT_PORT=8077 TARGET_PORT=9090 \
npx @modelcontextprotocol/inspector run

1. 打开浏览器访问检查器提供的 URL，选择 SSE 传输类型。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。