PropProfessor MCP

在支持 MCP 的 AI 客户端中使用 PropProfessor。

本项目为您提供：

• pp-mcp：用于 AI 代理的 MCP 服务器

• pp-query：用于设置检查和直接测试的本地 CLI

• sharp-plays-service：用于共享 sharp-play 编排的可重用包导出

最适合与 Claude Desktop、Cursor 和 Cline 等本地 MCP 客户端配合使用。

如果您使用 ChatGPT，请先参阅下方的 ChatGPT 注意事项。ChatGPT 目前的使用方式与本地 stdio MCP 客户端不同。

选择您的客户端

Related MCP server: pmcp

快速入门

1. 安装项目

2. 运行 pp-query install-auth --source /path/to/auth.json

3. 运行 pp-query doctor

4. 将 pp-mcp 添加到您的 MCP 客户端

功能说明

此 MCP 允许 AI 代理查询 PropProfessor 数据，例如：

• 已验证的正 EV (期望值) 候选对象

• 排名体育筛选器

• 联盟特定筛选器，如 NBA、MLB、NFL 和网球

• 基本健康检查

您无需了解内部工具名称即可开始使用。

所需条件

• Node.js 18 或更高版本

• PropProfessor 账户

• 已保存的 PropProfessor 登录浏览器会话

安装

git clone https://github.com/j17drake/propprofessor-mcp.git
cd propprofessor-mcp
npm install
npm link

执行 npm link 后，这些命令将在您的 PATH 中可用：

• pp-mcp

• pp-query

设置身份验证

最简单的方法：

pp-query install-auth --source /path/to/auth.json

这将把您保存的 PropProfessor 浏览器会话复制到默认位置：

~/.propprofessor/auth.json

这是本项目现在优先检查的默认位置。

身份验证查找顺序：

1. AUTH_FILE

2. ~/.propprofessor/auth.json

3. 本仓库中的 auth.json

如果您想使用其他位置，请设置 AUTH_FILE。

更多详情：AUTH.md

如果您还没有 auth.json，请参阅 AUTH.md 中的导出指南。

验证是否正常工作

运行：

pp-query doctor

该命令会检查：

• 您的 Node 版本

• 是否找到了身份验证文件

• 正在使用哪个身份验证路径

• PropProfessor 是否有响应

您也可以运行：

pp-query health

客户端设置

Claude Desktop

Claude Desktop 是使用本项目最好的方式之一。

请使用 CONFIG.md 中的 Claude Desktop 设置，然后尝试：

Check whether the PropProfessor MCP connection is healthy.

Cursor

Cursor 直接支持本地 stdio MCP 服务器。

请使用 CONFIG.md 中的 Cursor 设置，然后尝试：

Check whether the PropProfessor MCP connection is healthy.

Cline

Cline 通过其 MCP 设置文件支持本地 MCP 服务器。

请使用 CONFIG.md 中的 Cline 设置，然后尝试：

Check whether the PropProfessor MCP connection is healthy.

ChatGPT

ChatGPT 支持 MCP 的方式与本地 stdio MCP 客户端不同。

本仓库目前专为 Claude Desktop、Cursor 和 Cline 等本地 stdio MCP 客户端设计。ChatGPT 的 MCP 支持侧重于远程 MCP 服务器和 ChatGPT 应用，而不是直接启动此本地 pp-mcp 进程。

如果 ChatGPT 支持对您很重要，建议未来的方向是将此服务器公开为远程 MCP 端点。

请参阅 CONFIG.md 获取简要说明。

通用本地 MCP 客户端

如果您的客户端可以启动本地 stdio MCP 服务器，请使用 CONFIG.md 中的通用设置。

添加到您的 MCP 客户端

如果您的客户端支持本地 stdio MCP 服务器，请使用 CONFIG.md 中的客户端特定设置。

如果您的客户端未列出，请从通用本地 MCP 配置开始。

示例提示词

在您的 MCP 客户端中尝试这些提示词：

• Find the best validated positive EV NBA plays available right now.

• Show me the top NHL moneyline opportunities.

• Check whether the PropProfessor MCP connection is healthy.

• Rank today's tennis moneyline opportunities.

入门工具

如果您想先获取最有用的 MCP 工具列表：

• query_validated_positive_ev_candidates 排名和验证候选对象发现的最佳默认工具。

• query_nba_screen 简单的体育特定排名筛选查询。

• query_sport_screen 相同的概念，但适用于各个联盟。

• health_status 适用于连接故障排除。

CLI 命令

本地 CLI 主要用于设置检查和快速直接测试。

• pp-query doctor

• pp-query health

• pp-query screen --league NBA --market Moneyline

• pp-query nba --market Moneyline

• pp-query tennis --market Moneyline --limit 10

• pp-query sharp-plays --book Fliff --leagues NBA,MLB,NHL,Tennis --market Moneyline --limit 10

• pp-query ufc-card --book NoVigApp --market Moneyline

• pp-query list

完整 MCP 工具列表

• query_positive_ev_candidates

• query_validated_positive_ev_candidates

• query_screen_odds

• query_screen_odds_best_comps

• query_screen_odds_ranked

• query_sport_screen

• query_nba_screen

• query_wnba_screen

• query_mlb_screen

• query_nfl_screen

• query_nhl_screen

• query_ufc_screen

• query_ufc_card

• query_soccer_screen

• query_ncaab_screen

• query_ncaaf_screen

• query_tennis_screen

• query_sharp_plays

• league_presets

• health_status

故障排除

如果 pp-query doctor 显示缺少身份验证：

• 确保您已保存登录的 PropProfessor 浏览器会话

• 将其放置在 ~/.propprofessor/auth.json

• 或者将 AUTH_FILE 设置为正确的路径

如果 pp-query doctor 找到了身份验证但端点检查失败：

• 您的会话可能已过期

• 请重新登录并导出新的会话文件

如果 Claude Desktop、Cursor 或 Cline 无法启动服务器：

• 运行 pp-query doctor

• 确保 pp-mcp 在您的 PATH 中

• 如有必要，使用直接的 node /path/to/.../propprofessor-mcp-server.js 设置

如果您使用 ChatGPT：

• 本仓库目前不是直接的本地 stdio ChatGPT 设置

• 建议未来的方向是将其公开为远程 MCP 服务器

• 在此之前，Claude Desktop、Cursor 和 Cline 是使用它的最简单方式

高级设置

环境变量：

• AUTH_FILE，覆盖身份验证文件路径

• LOCAL_TIMEZONE，本地 CLI 显示时区，默认为 America/Chicago

• PROPPROFESSOR_MCP_NDJSON，设置为 true 以使用 NDJSON 框架

• PROPPROFESSOR_ODDS_HISTORY_LOOKBACK_HOURS，默认赔率历史回溯窗口（小时），默认为 6

按请求覆盖：

• MCP 排名工具接受 lookbackHours 和 debug

• 本地 CLI 助手接受 --lookback-hours 或 --lookbackHours

• 本地 CLI 助手也接受 --debug 或 --no-debug

维护者须知

发布和实时冒烟测试工作流程说明已移至 MAINTAINERS.md。