Polymarket Gamma MCP 서버

Polymarket Gamma Markets API와 연동하기 위한 MCP 서버 - 예측 시장, 이벤트 및 분석 데이터를 가져옵니다.

🚀 기능

📊 주요 기능:

• 트렌드 마켓 - 거래량이 높은 인기 마켓 가져오기

• 마켓 검색 - 질문 및 설명에서 텍스트 검색

• 카테고리 필터링 - 태그별 마켓 (Politics, Sports, Crypto)

• 마켓 상세 정보 - 특정 마켓에 대한 전체 정보

• 이벤트 - 관련 마켓과 함께 이벤트 가져오기

• API 사용량 - 요청 사용량 추적

🔧 기술적 특징:

• API 키 불필요 - Gamma API 공개 액세스

• TypeScript - 엄격한 타입 지정 및 데이터 검증

• 재시도 로직 - 네트워크 오류 시 자동 재시도

• 형식화된 출력 - 한국어로 편리한 데이터 표시

• 한도 추적 - API 사용량 모니터링

Related MCP server: Polymarket MCP Server

📦 설치

# Клонировать и установить зависимости
npm install

# Собрать проект
npm run build

# Запустить тесты
npm test

🛠️ 사용 가능한 도구

1. get_trending_markets

거래량이 높은 트렌드 마켓을 가져옵니다.

매개변수:

• limit (숫자, 기본값: 20) - 마켓 수

응답 예시:

{
  "summary": "Найдено 5 трендовых рынков",
  "apiUsage": "4/1000 запросов использовано, 996 осталось",
  "markets": "1. Will Joe Biden get Coronavirus before the election?\n   💰 Объём: $32,257 | 💧 Ликвидность: $0\n   🏷️ Теги: US-current-affairs\n   📊 Цены: Yes: 0.0% | No: 0.0%",
  "rawData": [...]
}

2. get_markets_by_category

카테고리/태그별 마켓을 가져옵니다.

매개변수:

• tags (문자열 배열, 필수) - 필터링할 카테고리

• limit (숫자, 기본값: 50) - 마켓 수

예시:

{
  "tags": ["Politics", "US Election"],
  "limit": 20
}

3. search_markets

텍스트 쿼리로 마켓을 검색합니다.

매개변수:

• query (문자열, 필수) - 검색어

• limit (숫자, 기본값: 30) - 결과 수

4. get_market_details

특정 마켓에 대한 상세 정보를 가져옵니다.

매개변수:

• marketId (문자열, 필수) - 마켓 ID

5. get_events

관련 마켓과 함께 이벤트를 가져옵니다.

매개변수:

• limit (숫자, 기본값: 20) - 이벤트 수

• active (불리언, 기본값: true) - 활성 이벤트만

• orderBy (문자열) - 정렬: volume, liquidity, endDate, createdAt

6. get_event_details

이벤트에 대한 상세 정보를 가져옵니다.

매개변수:

• eventId (문자열, 필수) - 이벤트 ID

7. get_api_usage

API 사용 통계를 가져옵니다.

🔗 API 엔드포인트

서버는 다음 Gamma API 엔드포인트를 사용합니다:

• GET /markets - 마켓 목록

• GET /markets/{id} - 마켓 상세 정보

• GET /events - 이벤트 목록

• GET /events/{id} - 이벤트 상세 정보

기본 URL: https://gamma-api.polymarket.com

📊 데이터 구조

ProcessedMarket

{
  id: string;
  question: string;
  description?: string;
  outcomes: string[];
  prices: number[];
  volume: number;
  liquidity: number;
  endDate: string;
  tags: string[];
  active: boolean;
  closed: boolean;
  resolved: boolean;
  negRisk: boolean;
  spread?: number;
  slug: string;
  tokens: Array<{
    id: string;
    outcome: string;
    price: number;
    winner?: boolean;
  }>;
}

ProcessedEvent

{
  id: string;
  title: string;
  description?: string;
  slug: string;
  tags: string[];
  startDate?: string;
  endDate?: string;
  active: boolean;
  closed: boolean;
  volume?: number;
  liquidity?: number;
  marketsCount: number;
  topMarkets?: ProcessedMarket[];
}

🧪 테스트

# Основные тесты
npm test

# Отладка API структуры
node test/debug-api.js

⚠️ 제한 사항

1. 공개 API - 키 없이 사용 가능하지만 합리적인 한도가 있음

2. 읽기 전용 - 주문을 넣을 수 없음 (CLOB API 필요)

3. 단순 검색 - 아직 전문 검색 없음

4. 지연된 데이터 - 실시간 시세 아님

🔄 Windsurf 통합

mcp_config.json에 추가:

{
  "mcpServers": {
    "polymarket-gamma": {
      "command": "node",
      "args": ["C:/Users/pavelk/Desktop/Projects/my_own/Bet/polymarket/mcp-servers/polymarket-gamma-server/dist/index.js"],
      "cwd": "C:/Users/pavelk/Desktop/Projects/my_own/Bet/polymarket/mcp-servers/polymarket-gamma-server"
    }
  }
}

📈 사용 사례

이 서버는 다음에 적합합니다:

• 마켓 분석 - 트렌드 및 거래량 조사

• 이벤트 모니터링 - 새로운 마켓 추적

• 연구 - 분석용 데이터 수집

• 기회 스크리닝 - 흥미로운 마켓 찾기

실제 거래에는 별도의 CLOB MCP 서버를 사용하세요.

🚀 다음 단계

1. ✅ Gamma API 서버 - 준비 완료 및 테스트됨

2. 🔄 CLOB API 서버 - 거래 작업용

3. 🔄 WebSocket 서버 - 실시간 데이터용

4. 🔄 통합 서버 - 모든 기능 통합