Odds De-vig MCP Server

The Odds API에서 스포츠 배당률을 가져오고 북메이커 마진(vig)을 제거하는 MCP 서버입니다.

✅ 최근 개선 사항 (v1.1.0)

• API 사용량 추적: 모든 응답에 이제 API 호출 잔여 횟수가 포함됩니다

• 재시도 로직: 연결 문제 시 자동 재시도 (3회)

• 향상된 오류 처리: 네트워크 오류 처리 개선

• 응답 형식: summary 및 apiUsage를 포함한 구조화된 응답

기능

도구 (Tools)

1. get_sports - 지원되는 스포츠 종목 목록 가져오기 (API 요청 없음)

2. get_today_mlb - 오늘 MLB 경기와 가공된 배당률 가져오기 (경제적)

3. get_upcoming_odds - 예정된 경기의 원시 배당률 가져오기 (기본값: 오늘 MLB 경기)

4. get_processed_odds - 마진이 제거된 가공 배당률 가져오기

5. get_event_consensus - 특정 이벤트의 컨센서스 라인 가져오기

6. get_api_usage - API 사용 통계 가져오기 (API 요청 1회)

리소스 (Resources)

• odds://sports - 지원되는 스포츠 종목 목록 (API 요청 없음)

• odds://today-mlb - 오늘 MLB 경기와 가공된 배당률

• odds://processed - 마진이 제거된 가공 배당률 (기본값: 오늘 MLB 경기)

마진 제거 방법

1. 비례 (Proportional) - 기본값

가장 간단하고 자주 사용되는 방법:

fair_probability = implied_probability / total_implied_probability

2. 거듭제곱 (Power/Shin)

더 복잡한 방법으로, 배당률 결과 수를 고려합니다:

fair_probability = implied_probability^n / total_implied_probability^(n-1)

3. 가산 (Additive)

모든 배당률 결과에 마진을 균등하게 분배합니다:

fair_probability = implied_probability - (total_vig / number_of_outcomes)

설치 및 실행

# Установка зависимостей
npm install

# Сборка
npm run build

# Запуск
npm start

# Разработка
npm run dev

구성

ODDS_API_KEY 환경 변수를 설정하거나 기본 키를 사용하세요:

export ODDS_API_KEY=your_api_key_here

⚠️ API 한도

중요: The Odds API는 무료 플랜의 경우 월 500회 요청 한도가 있습니다!

요청 최적화 방법:

• 기본적으로 오늘 MLB 경기만 요청합니다

• get_sports는 API 요청 없이 하드코딩된 목록을 반환합니다

• get_today_mlb는 데이터를 얻는 가장 경제적인 방법입니다

• 모든 요청은 API 사용량을 로깅합니다

권장 사항:

• 테스트에는 get_today_mlb를 사용하세요

• 테스트 시 하루 20회 요청으로 제한하세요

• get_api_usage를 통해 사용량을 모니터링하세요

사용 방법

스포츠 종목 목록 가져오기 (API 요청 없음)

{
  "tool": "get_sports"
}

오늘 MLB 경기 가져오기 (경제적)

{
  "tool": "get_today_mlb",
  "arguments": {
    "deVigMethod": "proportional"
  }
}

가공된 배당률 가져오기

{
  "tool": "get_processed_odds",
  "arguments": {
    "sport": "americanfootball_nfl",
    "deVigMethod": "proportional",
    "removeOutliers": true,
    "minBookmakers": 3
  }
}

컨센서스 라인 가져오기

{
  "tool": "get_event_consensus",
  "arguments": {
    "eventId": "event_id_from_api",
    "deVigMethod": "power"
  }
}

데이터 구조

ProcessedEvent

interface ProcessedEvent {
  id: string;
  sportKey: string;
  sportTitle: string;
  commenceTime: string;
  homeTeam: string;
  awayTeam: string;
  bookmakers: ProcessedBookmaker[];
  consensusLine?: {
    homeTeamFairOdds: number;
    awayTeamFairOdds: number;
    averageVig: number;
  };
}

ProcessedOutcome

interface ProcessedOutcome {
  name: string;
  americanOdds: number;
  decimalOdds: number;
  impliedProbability: number;
  fairProbability: number; // После удаления маржи
}

API 한도

중요: 월 500회 요청 한도!

현재 최적화:

• MLB에 집중 (매일 경기 진행)

• 오늘 경기만 요청

• 하드코딩된 스포츠 목록

• 모든 요청 로깅

모니터링:

{
  "tool": "get_api_usage"
}

반환:

{
  "requestsUsed": "15",
  "requestsRemaining": "485",
  "monthlyLimit": 500,
  "eventsFound": 12
}

다음 단계

1. Polymarket CLOB API 서버 - Polymarket 데이터 가져오기

2. 비교 서버 - 라인 비교 및 차익거래 탐색

3. 뉴스/SERP 서버 - 뉴스 및 컨텍스트 가져오기