PolyMarket MCP 서버

PolyMarket API를 통해 예측 시장 데이터에 접근할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 예측 시장에서 시장 정보, 가격 및 과거 데이터를 검색하기 위한 표준화된 인터페이스를 구현합니다.

특징

• 현재 가격과 확률을 포함한 실시간 예측 시장 데이터
• 카테고리, 해결 날짜 및 설명을 포함한 자세한 시장 정보
• 사용자 정의 가능한 기간(1일, 7일, 30일, 전체)을 통한 과거 가격 및 거래량 데이터
• 내장된 오류 처리 및 속도 제한 관리
• 간편한 사용을 위한 깔끔한 데이터 포맷

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 PolyMarket Predictions를 자동으로 설치하려면:

지엑스피1

클로드 데스크탑

• MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

지역적으로 실행

1. 저장소를 복제하고 종속성을 설치합니다.

라이브러리 설치

달리기

json 파일을 통해 Claude 클라이언트를 MCP 도구에 연결하고 패키지를 설치한 후 Claude는 서버의 mcp 도구를 볼 수 있어야 합니다.

다음을 통해 서버를 직접 실행할 수 있습니다. polymarket-mcp repo에서:

*서버와 함께 서버 검사기를 실행하려면:

2. PolyMarket API 키로 .env 파일을 만듭니다.

json 파일을 통해 Claude 클라이언트를 MCP 도구와 연결한 후 서버를 실행합니다. alpha-vantage-mcp repo에서: uv run src/polymarket_mcp/server.py

사용 가능한 도구

서버는 4가지 도구를 구현합니다.

• get-market-info : 특정 예측 시장에 대한 자세한 정보를 가져옵니다.
• list-markets : 필터링 옵션을 사용하여 사용 가능한 예측 시장을 나열합니다.
• get-market-prices : 현재 가격 및 거래 정보를 가져옵니다.
• get-market-history : 과거 가격 및 거래량 데이터 가져오기

시장 정보 얻기

입력 스키마:

응답 예시:

목록 시장

입력 스키마:

응답 예시:

시장 가격 얻기

입력 스키마:

응답 예시:

시장 이력 가져오기

입력 스키마:

응답 예시:

오류 처리

서버에는 다양한 시나리오에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 속도 제한(429 오류)
• 잘못된 API 키(403 오류)
• 잘못된 시장 ID(404 오류)
• 네트워크 연결 문제
• API 타임아웃 조건(30초 타임아웃)
• 잘못된 응답

오류 메시지는 사람이 읽을 수 있는 명확한 형식으로 반환됩니다.

필수 조건

• 파이썬 3.9 이상
• httpx>=0.24.0
• mcp-코어
• 파이썬-dotenv>=1.0.0

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 주요 변경 사항의 경우, 먼저 이슈를 열어 변경 사항을 논의해 주세요.