内容
# propline-mcp
[](https://www.npmjs.com/package/propline-mcp)
[](https://opensource.org/licenses/MIT)
在官方 [MCP 注册中心](https://registry.modelcontextprotocol.io) 中列出为 `io.github.proplineapi/propline-mcp` — 可从 Claude Code、Claude Desktop 和任何支持 MCP 的客户端发现。
**模型上下文协议服务器**，适用于 [PropLine](https://prop-line.com/?ref=mcp) 玩家属性投注赔率 API。将它插入 Claude Desktop、Claude Code 或任何兼容 MCP 的客户端，并询问有关实时赔率、属性结算、跨投注 +EV、比分和比赛统计数据等自然语言问题 — 模型会选择合适的工具、调用 API 并根据真实数据回答。
> 不再需要从 AI 助手那里听到“我需要一个 API 来实现这一点”的回应。PropLine MCP 将体育投注研究变成聊天。
## 你可以问
安装后，您可以提示模型：
- *"今晚洋基队对红袜队的 +EV 是多少？跨所有投注网站？"*
- *"拉取 Aaron Judge 最近 20 条属性投注历史，包含命中/未命中结果。"*
- *"列出今日 MLB 投手三振属性，从 DraftKings 和 Pinnacle 并排显示。"*
- *"尼古拉·约基奇的属性投注昨晚是否命中？赔率是多少？"*
- *"比较 PrizePicks DFS 预测与 Bovada 今晚 NBA 比赛的赔率。"*
- *"湖人队对凯尔特人队的首节总分是多少？哪家投注网站有最好的 Over 赔率？"*
模型透明地使用这些工具：
| 工具 | 功能 |
|------|--------------|
| `propline_list_sports` | 发现 PropLine 收集的体育项目（目前为 38 个） |
| `propline_list_events` | 体育比赛的即将到来的事件，附带 ID |
| `propline_list_event_markets` | 赛事可用的市场类型 |
| `propline_get_odds` | 实时赔率 — 按体育项目批量或按赛事获取完整属性。可接受 `period`（q1/h1/p1/f5/…）来限定比赛阶段市场。 |
| `propline_get_odds_history` | 高级：按结果快照历史；支持 `period`（q1/h1/…）和时间窗口过滤器（from/to, relative_from/relative_to, interval, changes_only） |
| `propline_get_odds_closing` | 高级：按（投注网站，市场，结果）的结算赔率 — CLV 助手。可接受 `period` 来限定特定比赛阶段。 |
| `propline_export_odds_history` | 回溯传递/企业：体育比赛的批量赔率变动历史（每个投注网站的每个快照）。需要 `since`/`until` 窗口；结果上限为 200 行（直接使用 REST 端点获取完整文件）。 |
| `propline_get_futures` | 赛季长期期货 — 冠军/分区/会议获胜者，MVP + 奖项，赛季胜场总数 — 跨 Bovada/FanDuel/DraftKings/Pinnacle（免费） |
| `propline_get_scores` | 比赛比分 + 状态（免费） |
| `propline_get_resolution_summary` | 等级属性交易量 + 按体育/市场分类（免费） |
| `propline_get_event_stats` | 原始比赛统计数据（免费，不区分投注网站） |
| `propline_get_event_context` | 比赛条件 — 可能的投手、阵容标记、本垒裁判、首球天气（免费） |
| `propline_get_event_movement` | 赔率变动 + 蒸汽检测（所有投注网站的 sharp-money 信号）从 tick 历史记录（高级） |
| `propline_get_event_results` | 专业：评级胜/负/平每属性 |
| `propline_get_player_history` | 具有结算的玩家属性历史 |
| `propline_get_player_trends` |命中率趋势 — 超过/低于/推分在最近 5/10/20/50 评级比赛中的分布，连续，平均实际值（可选 `dfs_odds_type` 以限定为 PrizePicks 风味）|
| `propline_get_event_ev` | 专业：跨投注网站 +EV 且无 vigorish 公平赔率 |
## 零配置快速入门
不需要密钥即可试用。服务器会回退到共享的公共演示密钥，因此可以直接使用：
```bash
npx -y propline-mcp
```
您的代理可以立即获取实时赔率、比分和统计数据。演示密钥是免费共享的 — 付费功能（结算、+EV、历史记录、导出）会返回一个编辑后的预览，并且限制在所有人之间共享。要获得完全访问权限和您自己的限制，请设置 `PROPLINE_API_KEY`（如下）。在 [prop-line.com](https://prop-line.com/?ref=mcp) 获取一个免费的个人密钥。
## 安装（使用您自己的密钥）
### 1. 获取 PropLine API 密钥
[prop-line.com](https://prop-line.com/?ref=mcp) — 免费层每天 1,000 次请求，无需信用卡。专业版每月 19 美元解锁结算、历史记录和 +EV。
### 2. 添加到您的 MCP 客户端
#### Claude Desktop
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或 `%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"propline": {
"command": "npx",
"args": ["-y", "propline-mcp"],
"env": {
"PROPLINE_API_KEY": "YOUR_KEY_HERE"
}
}
}
}
```
重启 Claude Desktop。锤子图标应显示 13 个 PropLine 工具。
#### Claude Code
```bash
claude mcp add propline \
--env PROPLINE_API_KEY=YOUR_KEY \
-- npx -y propline-mcp
```
#### 任何其他 MCP 客户端
以 stdio 服务器运行 `propline-mcp`。大多数客户端接受命令 + 环境变量。请参阅 [MCP 规范](https://modelcontextprotocol.io/) 以获取客户端特定的配置。
## 配置
| 环境变量 | 是否必需 | 默认值 | 备注 |
|--------|:--------:|---------|-------|
| `PROPLINE_API_KEY` | 否 | 共享演示密钥 | 未设置 = 共享免费演示密钥（付费功能编辑，限制共享）。在 [prop-line.com](https://prop-line.com/?ref=mcp) 设置您自己的免费密钥以获得完全访问权限。 |
| `PROPLINE_BASE_URL` | 否 | `https://api.prop-line.com` | 自托管设置的覆盖 |
## 与 the-odds-api 比较
PropLine 在响应级别上与 API 兼容（相同的 `bookmakers[].markets[].outcomes[]` 结构），并添加了 the-odds-api 在任何层级都不提供的三个功能：
1. **属性结算** — 每个 Over/Under 根据实际比赛统计数据进行评级
2. **跨投注网站 +EV** — 以 Pinnacle 为锚点的无 vigorish 公平赔率，按 +EV 玩法排序
3. **Webhooks** — 在 Streaming 层上推送交付，而不是仅拉取
定价：免费层每天 1,000 次请求（而他们每月 500 次），专业版每月 19 美元可获得 25,000 次请求/天，Streaming 层每月 79 美元可获得 1,000,000 次请求/天。无需信用数学。
## 许可证
MIT
