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. MCPクライアントに pp-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は、ローカルの stdio MCPクライアントとは異なる方法で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を使用している場合：

• 本リポジトリは現在、ChatGPTの直接的なローカル stdio セットアップではありません

• 推奨される今後の方向性は、リモート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 に移動しました。