mcp-odds-api

Name: mcp-odds-api
Author: marcoeg

本地服务

github.com/marcoeg开发工具478 周前更新

代码仓库

关于 mcp-odds-api

mcp-odds-api 是用于查询 OddsAPI 体育赛事和赔率的 MCP 服务。它通过环境变量限制地区和单项运动查询，并支持 SSE 与 STDIO 传输。

主要功能

01获取进行中和即将开始的赛事
02查询所选市场的赔率
03获取指定赛事的赔率
04按地区和运动限制查询
05支持 SSE 与 STDIO 传输

适用场景

01查看正在进行及即将开始的比赛
02查询所选市场的赔率
03获取特定比赛的赔率

MCP 相关

它将 OddsAPI 的赛事与赔率查询作为 MCP 工具提供：`get_events`、`get_odds` 和 `get_event_odds`，支持 SSE 与 STDIO 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "odds-api": {
      "command": "uvx",
      "args": [
        "/path/to/.env"
      ]
    }
  }
}

启动命令uvx /path/to/.env

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypi/path/to/.envstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

mcp-odds-api

一个简约的 Model Context Protocol MCP 服务，用于与 OddsAPI 交互。

功能

使用环境变量将查询限制为指定地区和单一体育项目。

支持 SSE 和 STDIO 传输方式。

工具

该服务实现了以下工具，用于与 OddsAPI 交互：

get_events：
- 获取正在进行和即将开始的赛事（比赛）。
get_odds：
- 获取所选投注市场中所有即将开始的赛事（比赛）的赔率。
get_event_odds：
- 获取指定赛事（比赛）在所选投注市场中的赔率。

配置

创建或编辑 Claude Desktop 配置文件，文件位置如下：
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%/Claude/claude_desktop_config.json
添加以下内容：

{
  "mcpServers": {
    "mcp-bauplan": {
      "command": "/path/to/uvx",
      "args": ["mcp-odds-api"],
      "env": {
        "ODDS_API_KEY": "<your-api-odds-key>",
        "ODDS_API_REGIONS": "<region1>", "<region2>",
        "ODDS_API_SPORT": "<selected-sport-key>",
      }
    }
  }
}

将 /path/to/uvx 替换为 uvx 可执行文件的绝对路径。在终端中使用 which uvx 命令查找路径。这可确保启动服务时使用正确版本的 uvx。
重启 Claude Desktop 以应用更改。

运行独立的 SSE 服务

根据 .env.example 创建 .env 文件，然后执行以下命令：

$ uvx --env-file /path/to/.env mcp-odds-api --transport sse --port 9090

请注意，使用 nvx 而不是 uvx 会从默认注册表 https://pypi.org 获取 mcp-bauplan。

开发

设置

先决条件：
- Python 3.10 或更高版本。
- OddsAPI 密钥（在此申请）。
- uv 包管理器（安装说明）。
克隆仓库：

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

设置环境变量：
- 在项目根目录中创建 .env 文件：
ODDS_API_KEY="" ODDS_API_REGIONS="", "" ODDS_API_SPORT=""
安装依赖项：

uv sync
uv pip install -e .

使用 SSE 传输方式启动服务

$ uv run mcp-odds-api --transport sse --port 9090
python-dotenv could not parse statement starting at line 2
2025-04-30 19:35:34 - dotenv.main - WARNING - python-dotenv could not parse statement starting at line 2
INFO:     Started server process [68314]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:9090 (Press CTRL+C to quit)

运行 Inspector：

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

Starting MCP inspector...
⚙️ Proxy server listening on port 6277
🔍 MCP Inspector is up and running at http://127.0.0.1:8077 🚀

然后在浏览器中打开 MCP Inspector 指示的 URL。选择 SSE 传输类型。

支持 Markdown

登录后评论