caiovicentino/polymarket-mcp-server

🤖 AI-Powered MCP Server for Polymarket - Enable Claude to trade prediction markets with 45 tools, real-time monitoring, and enterprise-grade safety features

🤖 Polymarket MCP Server – Polymarket을 위한 AI 확장 거래 시스템

개요 – Anthropic의 Claude가 Polymarket 예측 시장 API와 상호 작용할 수 있도록 Model Context Protocol (MCP)을 구현한 Python 기반 서버입니다. 45가지의 즉시 사용 가능한 "도구"(함수)를 제공하여 Claude(또는 MCP 호환 에이전트)가 시장을 발견하고, 오더북을 분석하며, 주문을 배치 및 관리하고, 포트폴리오를 실시간으로 모니터링할 수 있게 합니다.

중요성 – 예측 시장 거래는 자율 에이전트에게 틈새시장이지만 성장 중인 분야입니다. Polymarket의 CLOB, Gamma 및 WebSocket 엔드포인트를 안전 우선 MCP 서버로 래핑함으로써, 이 프로젝트는 대규모 언어 모델 에이전트가 구성 가능한 위험 제한을 준수하면서 반자율적인 트레이더로 기능할 수 있도록 합니다.

핵심 기능 (5가지 도구 카테고리)

카테고리	도구	기능
시장 발견 (8)	키워드 검색, 트렌드 목록, 카테고리 필터, 마감 임박 알림, 스포츠 및 암호화폐 시장 브라우저	전략이나 관심사에 맞는 시장을 빠르게 찾습니다.
시장 분석 (10)	실시간 가격/스프레드, 오더북 깊이, 유동성 및 거래량 지표, 과거 가격, AI 생성 BUY/SELL/HOLD 신호, 다중 시장 비교, 대량 보유자 스캔, 위험 점수	데이터 기반 통찰력을 얻고 Claude가 생성한 추천을 모든 시장에서 활용합니다.
거래 (12)	지정가 및 시장가 주문 (GTC, GTD, FOK, FAK), 일괄 제출, AI 추천 가격, 주문 상태 추적, 일괄 취소, 자연어 기반 전략 실행, 슬리피지 보호가 포함된 포지션 리밸런싱	프로그램 또는 자연어 프롬프트를 통해 주문을 배치하고 관리합니다.
포트폴리오 관리 (8)	실시간 포지션 보기, 실현/미실현 손익, 총 포트폴리오 가치, 집중도 및 다각화 위험 분석, 온체인 활동 로그, AI 기반 포트폴리오 최적화 (보수적/균형적/공격적)	노출 상태를 항상 파악하고 Claude가 조정을 제안하도록 합니다.
실시간 모니터링 (7)	WebSocket 가격 스트림, 오더북 깊이 스트림, 주문 상태 알림, 실행 경고, 시장 결제 알림, 구독 처리, 지수 백오프를 통한 자동 재연결	정보를 즉시 파악합니다. 대시보드에서 이러한 스트림을 시각화합니다.

안전 및 위험 관리 계층

주문 크기, 총 노출, 시장별 포지션, 최소 시장 유동성 및 최대 스프레드에 대한 구성 가능한 상한 설정.
거래 전 검증 및 확인 흐름 (대량 주문은 명시적인 confirm=true가 필요할 수 있음).
토큰 버킷 알고리즘을 통한 속도 제한 (Polymarket의 API 제한 준수).
EIP-712 서명 주문 및 지갑 기반 인증 (Polygon 개인 키 + 주소).

프로덕션 준비 인프라

MCP server는 Python 3.10+로 작성되었으며 pip install -e .로 설치 가능.
Web dashboard (polymarket-web 또는 ./start_web_dashboard.sh)는 http://localhost:8080에서 실행되며 시각적 구성, 실시간 통계 및 시장 브라우징 제공.
모의 테스트 없음 – 테스트 스위트는 실제 Polymarket API를 호출하여 프로덕션 엔드포인트에서 코드가 작동함을 보장.
완벽한 테스트 커버리지 및 CI 준비 스크립트 (pytest, coverage reports).

시작하기 (퀵스타트)

# 데모 (읽기 전용) – 지갑 불필요
curl -sSL https://raw.githubusercontent.com/caiovicentino/polymarket-mcp-server/main/quickstart.sh | bash

# 전체 설치 (거래) – venv 생성, 의존성 설치 및 Claude-Desktop 통합 실행
./install.sh               # macOS / Linux
install.bat                # Windows

.env 편집 – 읽기 전용 모드는 DEMO_MODE=true를 설정하고, 실거래는 POLYGON_PRIVATE_KEY와 POLYGON_ADDRESS를 제공하십시오. 필요에 따라 안전 제한을 조정하십시오.

에이전트 사용 방법

Claude(또는 MCP 호환 LLM)는 market_analysis나 place_limit_order와 같은 도구 이름을 호출하는 JSON-RPC 요청을 서버로 보냅니다. 서버는 구조화된 데이터(가격, 위험 점수, 주문 확인)를 반환하며, Claude는 이를 다음 추론 단계에 통합할 수 있습니다. 이러한 왕복 통신을 통해 자연어 기반의 자율 거래가 가능하며, 서버는 .env에 정의된 안전 정책을 강제합니다.

대상 사용자

연구원: AI 기반 예측 시장 전략을 탐구하는 분.
퀀트 팀: Polymarket으로의 신뢰할 수 있는 브릿지가 필요한 맞춤형 에이전트를 구축하는 분.
개인 트레이더: 시장 발견 및 위험 관리 실행을 위해 Claude의 도움을 받고 싶은 분.

라이선스 및 커뮤니티

MIT 라이선스 – 상업적 또는 개인적 용도로 무료 사용 가능.
GitHub Issues, Discussions 및 Telegram(저장소에서 링크)에서 활발한 커뮤니티 운영.
기여 가이드와 향후 CI/CD, 백테스팅, 다중 지갑 지원 및 더 풍부한 AI 분석 도구가 나열된 "로드맵" 제공.

결론

Polymarket MCP Server는 Anthropic의 Claude(MCP 프로토콜 경유)와 Polymarket 예측 시장 생태계를 잇는 진정한 프로덕션급 브릿지입니다. 강력한 도구 상자, 안전 검사 및 웹 UI를 통합하여 오늘날 예측 시장에서 자율 AI 거래를 위한 가장 완벽한 오픈 소스 스택 중 하나입니다.