PropProfessor MCP

Используйте PropProfessor в AI-клиентах, поддерживающих MCP.

Этот проект предоставляет:

• pp-mcp: MCP-сервер для AI-агентов

• pp-query: локальный CLI для проверки настроек и прямого тестирования

• sharp-plays-service: переиспользуемый пакет для оркестрации sharp-plays

Лучше всего работает с локальными MCP-клиентами, такими как Claude Desktop, Cursor и Cline.

Если вы используете 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 — один из лучших способов использования этого проекта.

Используйте настройку Claude Desktop в CONFIG.md, затем попробуйте:

Check whether the PropProfessor MCP connection is healthy.

Cursor

Cursor поддерживает локальные stdio MCP-серверы напрямую.

Используйте настройку Cursor в CONFIG.md, затем попробуйте:

Check whether the PropProfessor MCP connection is healthy.

Cline

Cline поддерживает локальные MCP-серверы через свой файл настроек MCP.

Используйте настройку Cline в CONFIG.md, затем попробуйте:

Check whether the PropProfessor MCP connection is healthy.

ChatGPT

ChatGPT поддерживает MCP иначе, чем локальные stdio MCP-клиенты.

Этот репозиторий в настоящее время разработан для локальных stdio MCP-клиентов, таких как Claude Desktop, Cursor и Cline. Поддержка MCP в ChatGPT ориентирована на удаленные 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.