关于 kingsplaybook-mcp
kingsplaybook-mcp 将 AI Agent 和体育分析工具连接到 KingsPlaybook API,获取 NBA、MLB 和 NHL 数据。它以本地 stdio 封装提供阵容、预测、比赛盘口、选单历史及数据新鲜度信息。
主要功能
- 01获取 NBA、MLB 和 NHL 确认阵容
- 02查询球员预测数据
- 03访问聚合比赛盘口
- 04查看已发布选单及结果
- 05检查各数据域的新鲜度
适用场景
- 01查看指定联赛和日期的确认阵容
- 02获取某场赛程的球员预测
- 03结合结果和收盘盘口回顾历史选单
MCP 相关
本地 stdio MCP 服务将 KingsPlaybook API 数据作为工具开放。MCP 客户端使用 API 密钥运行服务,以查询阵容、预测、比赛盘口、选单历史和数据新鲜度。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y kingsplaybook-mcpKINGSPLAYBOOK_API_KEY密钥Your kp_live_ API key from https://kingsplaybook.org/devsKINGSPLAYBOOK_API_URLOverride the API base URL (default https://api.kingsplaybook.org)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
5收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| date | string | 是 | 比赛日期,ISO-8601(YYYY-MM-DD) |
| league | enum | 是 | 联盟:nba、mlb 或 nhlnba | mlb | nhl |
详细介绍
kingsplaybook-mcp
KingsPlaybook Developer API 的官方 MCP 服务。它让 AI Agent——无论是构建体育博彩机器人、模型还是分析工具——都能通过原生工具直接访问 KingsPlaybook 的数据:
- 已确认阵容 — NBA、MLB、NHL
- 球员预测 — 预测引擎的原始输出
- 标准化比赛赔率 — 胜负赔率 / 让分 / 大小分,汇总自多个博彩公司
- 投注记录归档 — 已公开发布的记录,包含赛果和临场赔率
这是对 /v1 REST API 的轻量本地(stdio)封装。
同样的数据,另一个协议。
获取 API 密钥
在 kingsplaybook.org/devs 注册。免费方案支持阵容数据;付费方案还支持预测、赔率和历史记录。
你的密钥格式为 kp_live_…。
安装
无需安装步骤——直接通过 npm 使用 npx 运行。将其添加到 MCP
客户端配置中(Claude Desktop、Cursor 等):
{
"mcpServers": {
"kingsplaybook": {
"command": "npx",
"args": ["-y", "kingsplaybook-mcp"],
"env": {
"KINGSPLAYBOOK_API_KEY": "kp_live_your_key_here"
}
}
}
}
就是这样——Agent 现在可以使用 KingsPlaybook 工具了。
工具
| 工具 | 返回内容 | 最低方案 |
|---|---|---|
kingsplaybook_get_lineups | 指定联赛和日期的已确认阵容 | 免费 |
kingsplaybook_get_projections | 指定联赛和日期的原始球员预测 | Starter |
kingsplaybook_get_lines | 指定联赛和日期的标准化比赛赔率 | Pro |
kingsplaybook_get_pick_history | 指定日期已发布的投注和赛果 | Premium |
kingsplaybook_get_freshness | 各数据领域的数据时效信号 | 免费 |
每个工具都返回 JSON。调用超出你的方案等级的工具时,会返回清晰的 403 消息和升级链接。
示例
- “今晚的 NBA 赛程如何?” →
kingsplaybook_get_lineups({ league: "nba", date: "2026-05-21" }) - “获取今天的 MLB 预测” →
kingsplaybook_get_projections({ league: "mlb", date: "2026-05-21" }) - “KingsPlaybook 昨天的球员道具投注表现如何?” →
kingsplaybook_get_pick_history({ date: "2026-05-20", type: "prop" })
配置
| 环境变量 | 必填 | 默认值 | 用途 |
|---|---|---|---|
KINGSPLAYBOOK_API_KEY | 是 | — | 你的 kp_live_ API 密钥 |
KINGSPLAYBOOK_API_URL | 否 | https://api.kingsplaybook.org | 覆盖 API 基础 URL |
本地开发
npm install
npm run build # compile TypeScript to dist/
npm start # run the built server (needs KINGSPLAYBOOK_API_KEY)
npm run dev # watch mode
链接
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。