PropProfessor MCP

Utiliza PropProfessor desde clientes de IA que soporten MCP.

Este proyecto te ofrece:

• pp-mcp, el servidor MCP para agentes de IA

• pp-query, la CLI local para comprobaciones de configuración y pruebas directas

• sharp-plays-service, el paquete reutilizable para la orquestación compartida de sharp-plays

Funciona mejor con clientes MCP locales como Claude Desktop, Cursor y Cline.

Si utilizas ChatGPT, consulta primero la nota sobre ChatGPT a continuación. Actualmente, ChatGPT no utiliza este proyecto de la misma manera que los clientes MCP locales de stdio.

Elige tu cliente

Related MCP server: pmcp

Inicio rápido

1. Instala el proyecto

2. Ejecuta pp-query install-auth --source /ruta/a/auth.json

3. Ejecuta pp-query doctor

4. Añade pp-mcp a tu cliente MCP

Qué hace

Este MCP permite a un agente de IA consultar datos de PropProfessor para cosas como:

• candidatos validados con EV positivo

• pantallas de deportes clasificadas

• pantallas específicas de ligas como NBA, MLB, NFL y tenis

• comprobaciones básicas de estado

No necesitas entender los nombres internos de las herramientas para empezar.

Qué necesitas

• Node.js 18 o superior

• Una cuenta de PropProfessor

• Una sesión de navegador guardada e iniciada para PropProfessor

Instalación

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

Después de npm link, estos comandos estarán disponibles en tu PATH:

• pp-mcp

• pp-query

Configurar autenticación

La opción más fácil:

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

Eso copia tu sesión de navegador guardada de PropProfessor a la ubicación predeterminada:

~/.propprofessor/auth.json

Esta es la ubicación predeterminada que el proyecto comprueba primero ahora.

Orden de búsqueda de autenticación:

1. AUTH_FILE

2. ~/.propprofessor/auth.json

3. auth.json en este repositorio

Si quieres usar una ubicación diferente, establece AUTH_FILE.

Más detalles: AUTH.md

Si aún no tienes un auth.json, consulta la guía de exportación en AUTH.md.

Verifica que funciona

Ejecuta:

pp-query doctor

Ese comando comprueba:

• tu versión de Node

• si se encontró un archivo de autenticación

• qué ruta de autenticación se está utilizando

• si PropProfessor responde

También puedes ejecutar:

pp-query health

Configuración del cliente

Claude Desktop

Claude Desktop es una de las mejores formas de usar este proyecto.

Utiliza la configuración de Claude Desktop en CONFIG.md, luego intenta:

Comprueba si la conexión MCP de PropProfessor es saludable.

Cursor

Cursor soporta servidores MCP locales stdio directamente.

Utiliza la configuración de Cursor en CONFIG.md, luego intenta:

Comprueba si la conexión MCP de PropProfessor es saludable.

Cline

Cline soporta servidores MCP locales a través de su archivo de configuración MCP.

Utiliza la configuración de Cline en CONFIG.md, luego intenta:

Comprueba si la conexión MCP de PropProfessor es saludable.

ChatGPT

ChatGPT soporta MCP de una manera diferente a los clientes MCP locales stdio.

Este repositorio está diseñado actualmente para clientes MCP locales stdio como Claude Desktop, Cursor y Cline. El soporte MCP de ChatGPT está orientado a servidores MCP remotos y aplicaciones de ChatGPT, no a iniciar este proceso local pp-mcp directamente.

Si el soporte para ChatGPT es importante para ti, la dirección futura recomendada es exponer este servidor como un endpoint MCP remoto.

Consulta CONFIG.md para una breve explicación.

Cliente MCP local genérico

Si tu cliente puede iniciar un servidor MCP local stdio, utiliza la configuración genérica en CONFIG.md.

Añádelo a tu cliente MCP

Si tu cliente soporta servidores MCP locales stdio, utiliza la configuración específica del cliente en CONFIG.md.

Si tu cliente no aparece en la lista, empieza con la configuración MCP local genérica.

Ejemplos de prompts

Prueba estos en tu cliente MCP:

• Encuentra las mejores jugadas de EV positivo validadas de la NBA disponibles ahora mismo.

• Muéstrame las mejores oportunidades de moneyline de la NHL.

• Comprueba si la conexión MCP de PropProfessor es saludable.

• Clasifica las oportunidades de moneyline de tenis de hoy.

Herramientas para empezar

Si quieres una lista corta de las herramientas MCP más útiles primero:

• query_validated_positive_ev_candidates La mejor opción predeterminada para el descubrimiento de candidatos clasificados y validados.

• query_nba_screen Consulta de pantalla clasificada simple específica para deportes.

• query_sport_screen La misma idea, pero funciona en todas las ligas.

• health_status Útil para solucionar problemas de conexión.

Comandos CLI

La CLI local es principalmente para comprobaciones de configuración y pruebas directas rápidas.

• 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

Lista completa de herramientas 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

Solución de problemas

Si pp-query doctor dice que falta la autenticación:

• asegúrate de haber guardado tu sesión de navegador de PropProfessor iniciada

• colócala en ~/.propprofessor/auth.json

• o establece AUTH_FILE en la ruta correcta

Si pp-query doctor encuentra la autenticación pero la comprobación del endpoint falla:

• tu sesión puede estar caducada

• inicia sesión de nuevo y exporta un archivo de sesión nuevo

Si Claude Desktop, Cursor o Cline no pueden iniciar el servidor:

• ejecuta pp-query doctor

• asegúrate de que pp-mcp esté en tu PATH

• si es necesario, utiliza la configuración directa node /ruta/a/.../propprofessor-mcp-server.js

Si utilizas ChatGPT:

• este repositorio no es actualmente una configuración directa de ChatGPT stdio local

• la dirección futura recomendada es exponerlo como un servidor MCP remoto

• hasta entonces, Claude Desktop, Cursor y Cline son las formas más fáciles de usarlo

Configuración avanzada

Variables de entorno:

• AUTH_FILE, sobrescribe la ruta del archivo de autenticación

• LOCAL_TIMEZONE, zona horaria de visualización de la CLI local, predeterminado America/Chicago

• PROPPROFESSOR_MCP_NDJSON, establecer en true para el formato NDJSON

• PROPPROFESSOR_ODDS_HISTORY_LOOKBACK_HOURS, ventana de búsqueda retrospectiva del historial de cuotas predeterminada en horas, predeterminado 6

Sobrescrituras por solicitud:

• Las herramientas clasificadas de MCP aceptan lookbackHours y debug

• Los ayudantes de la CLI local aceptan --lookback-hours o --lookbackHours

• Los ayudantes de la CLI local también aceptan --debug o --no-debug

Para mantenedores

Las notas sobre el flujo de trabajo de lanzamiento y pruebas en vivo se han movido a MAINTAINERS.md.