PropProfessor MCP

Verwenden Sie PropProfessor mit KI-Clients, die MCP unterstützen.

Dieses Projekt bietet Ihnen:

• pp-mcp, den MCP-Server für KI-Agenten

• pp-query, das lokale CLI für Einrichtungsprüfungen und direkte Tests

• sharp-plays-service, das wiederverwendbare Paket-Export für gemeinsame Sharp-Play-Orchestrierung

Funktioniert am besten mit lokalen MCP-Clients wie Claude Desktop, Cursor und Cline.

Wenn Sie ChatGPT verwenden, lesen Sie zuerst den Hinweis zu ChatGPT weiter unten. ChatGPT verwendet dieses Projekt derzeit nicht auf die gleiche Weise wie lokale stdio MCP-Clients.

Wählen Sie Ihren Client

Related MCP server: pmcp

Schnellstart

1. Installieren Sie das Projekt

2. Führen Sie pp-query install-auth --source /pfad/zu/auth.json aus

3. Führen Sie pp-query doctor aus

4. Fügen Sie pp-mcp zu Ihrem MCP-Client hinzu

Was es tut

Dieses MCP ermöglicht es einem KI-Agenten, PropProfessor-Daten abzufragen, zum Beispiel für:

• validierte positive EV-Kandidaten

• gerankte Sport-Screens

• Ligaspezifische Screens wie NBA, MLB, NFL und Tennis

• grundlegende Gesundheitsprüfungen

Sie müssen die internen Tool-Namen nicht verstehen, um loszulegen.

Was Sie benötigen

• Node.js 18 oder neuer

• Ein PropProfessor-Konto

• Eine gespeicherte, eingeloggte Browsersitzung für PropProfessor

Installation

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

Nach npm link sind diese Befehle in Ihrem PATH verfügbar:

• pp-mcp

• pp-query

Authentifizierung einrichten

Einfachste Option:

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

Dies kopiert Ihre gespeicherte PropProfessor-Browsersitzung an den Standardspeicherort:

~/.propprofessor/auth.json

Dies ist der Standardspeicherort, den das Projekt jetzt zuerst überprüft.

Reihenfolge der Authentifizierungssuche:

1. AUTH_FILE

2. ~/.propprofessor/auth.json

3. auth.json in diesem Repo

Wenn Sie einen anderen Speicherort verwenden möchten, setzen Sie AUTH_FILE.

Weitere Details: AUTH.md

Wenn Sie noch keine auth.json haben, lesen Sie die Exportanleitung in AUTH.md.

Überprüfen, ob es funktioniert

Führen Sie aus:

pp-query doctor

Dieser Befehl überprüft:

• Ihre Node-Version

• ob eine Authentifizierungsdatei gefunden wurde

• welcher Authentifizierungspfad verwendet wird

• ob PropProfessor antwortet

Sie können auch ausführen:

pp-query health

Client-Einrichtung

Claude Desktop

Claude Desktop ist eine der besten Möglichkeiten, dieses Projekt zu nutzen.

Verwenden Sie die Claude Desktop-Einrichtung in CONFIG.md und versuchen Sie dann:

Check whether the PropProfessor MCP connection is healthy.

Cursor

Cursor unterstützt lokale stdio MCP-Server direkt.

Verwenden Sie die Cursor-Einrichtung in CONFIG.md und versuchen Sie dann:

Check whether the PropProfessor MCP connection is healthy.

Cline

Cline unterstützt lokale MCP-Server über seine MCP-Einstellungsdatei.

Verwenden Sie die Cline-Einrichtung in CONFIG.md und versuchen Sie dann:

Check whether the PropProfessor MCP connection is healthy.

ChatGPT

ChatGPT unterstützt MCP auf eine andere Weise als lokale stdio MCP-Clients.

Dieses Repo ist derzeit für lokale stdio MCP-Clients wie Claude Desktop, Cursor und Cline konzipiert. Die MCP-Unterstützung von ChatGPT ist auf Remote-MCP-Server und ChatGPT-Apps ausgerichtet, nicht auf das direkte Starten dieses lokalen pp-mcp-Prozesses.

Wenn die Unterstützung für ChatGPT für Sie wichtig ist, ist die empfohlene zukünftige Richtung, diesen Server als Remote-MCP-Endpunkt bereitzustellen.

Siehe CONFIG.md für die kurze Erklärung.

Generischer lokaler MCP-Client

Wenn Ihr Client einen lokalen stdio MCP-Server starten kann, verwenden Sie die generische Einrichtung in CONFIG.md.

Fügen Sie es Ihrem MCP-Client hinzu

Wenn Ihr Client lokale stdio MCP-Server unterstützt, verwenden Sie die clientspezifische Einrichtung in CONFIG.md.

Wenn Ihr Client nicht aufgeführt ist, beginnen Sie mit der generischen lokalen MCP-Konfiguration.

Beispiel-Prompts

Versuchen Sie diese in Ihrem MCP-Client:

• 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.

Start-Tools

Wenn Sie zuerst eine kurze Liste der nützlichsten MCP-Tools wünschen:

• query_validated_positive_ev_candidates Beste Standardeinstellung für die Entdeckung gerankter, validierter Kandidaten.

• query_nba_screen Einfache sportspezifische gerankte Screen-Abfrage.

• query_sport_screen Gleiche Idee, funktioniert aber über Ligen hinweg.

• health_status Gut für die Fehlerbehebung bei Verbindungen.

CLI-Befehle

Das lokale CLI dient hauptsächlich der Einrichtungsprüfung und schnellen direkten Tests.

• 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

Vollständige MCP-Tool-Liste

• 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

Fehlerbehebung

Wenn pp-query doctor meldet, dass die Authentifizierung fehlt:

• stellen Sie sicher, dass Sie Ihre eingeloggte PropProfessor-Browsersitzung gespeichert haben

• legen Sie sie unter ~/.propprofessor/auth.json ab

• oder setzen Sie AUTH_FILE auf den korrekten Pfad

Wenn pp-query doctor die Authentifizierung findet, aber die Endpunktprüfung fehlschlägt:

• Ihre Sitzung könnte abgelaufen sein

• loggen Sie sich erneut ein und exportieren Sie eine neue Sitzungsdatei

Wenn Claude Desktop, Cursor oder Cline den Server nicht starten können:

• führen Sie pp-query doctor aus

• stellen Sie sicher, dass pp-mcp in Ihrem PATH ist

• verwenden Sie bei Bedarf die direkte node /pfad/zu/.../propprofessor-mcp-server.js-Einrichtung

Wenn Sie ChatGPT verwenden:

• dieses Repo ist derzeit keine direkte lokale stdio ChatGPT-Einrichtung

• die empfohlene zukünftige Richtung ist die Bereitstellung als Remote-MCP-Server

• bis dahin sind Claude Desktop, Cursor und Cline die einfachsten Möglichkeiten, es zu nutzen

Erweiterte Einstellungen

Umgebungsvariablen:

• AUTH_FILE, überschreibt den Pfad der Authentifizierungsdatei

• LOCAL_TIMEZONE, Zeitzone für die lokale CLI-Anzeige, Standard America/Chicago

• PROPPROFESSOR_MCP_NDJSON, auf true setzen für NDJSON-Framing

• PROPPROFESSOR_ODDS_HISTORY_LOOKBACK_HOURS, Standard-Lookback-Fenster für die Quotenhistorie in Stunden, Standard 6

Anfrage-spezifische Überschreibungen:

• MCP-gerankte Tools akzeptieren lookbackHours und debug

• lokale CLI-Helfer akzeptieren --lookback-hours oder --lookbackHours

• lokale CLI-Helfer akzeptieren auch --debug oder --no-debug

Für Betreuer

Release- und Live-Smoke-Workflow-Notizen wurden nach MAINTAINERS.md verschoben.