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 지원은 이 로컬 pp-mcp 프로세스를 직접 실행하는 것이 아니라 원격 MCP 서버 및 ChatGPT 앱을 중심으로 구성되어 있습니다.

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: NDJSON 프레이밍을 위해 true로 설정

• PROPPROFESSOR_ODDS_HISTORY_LOOKBACK_HOURS: 기본 배당률 기록 조회 창(시간 단위), 기본값 6

요청별 재정의:

• MCP 순위 도구는 lookbackHours 및 debug를 허용합니다.

• 로컬 CLI 도우미는 --lookback-hours 또는 --lookbackHours를 허용합니다.

• 로컬 CLI 도우미는 --debug 또는 --no-debug도 허용합니다.

유지 관리자용

릴리스 및 라이브 스모크 워크플로우 노트는 MAINTAINERS.md로 이동되었습니다.