PolyMarket MCP 서버
PolyMarket API를 통해 예측 시장 데이터에 접근할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 예측 시장에서 시장 정보, 가격 및 과거 데이터를 검색하기 위한 표준화된 인터페이스를 구현합니다.
특징
현재 가격과 확률을 포함한 실시간 예측 시장 데이터
카테고리, 해결 날짜 및 설명을 포함한 자세한 시장 정보
사용자 정의 가능한 기간(1일, 7일, 30일, 전체)을 통한 과거 가격 및 거래량 데이터
내장된 오류 처리 및 속도 제한 관리
간편한 사용을 위한 깔끔한 데이터 포맷
Related MCP server: MercadoLibre MCP Server
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 PolyMarket Predictions를 자동으로 설치하려면:
지엑스피1
클로드 데스크탑
MacOS의 경우:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows의 경우:
%APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"polymarket-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/{INSERT_USER}/YOUR/PATH/TO/polymarket-mcp",
"run",
"polymarket-mcp" //or src/polymarket_mcp/server.py
],
"env": {
"KEY": "<insert poly market api key>",
"FUNDER": "<insert polymarket wallet address"
}
}
}지역적으로 실행
저장소를 복제하고 종속성을 설치합니다.
라이브러리 설치
uv pip install -e .달리기
json 파일을 통해 Claude 클라이언트를 MCP 도구에 연결하고 패키지를 설치한 후 Claude는 서버의 mcp 도구를 볼 수 있어야 합니다.
다음을 통해 서버를 직접 실행할 수 있습니다. polymarket-mcp repo에서:
uv run src/polymarket_mcp/server.py*서버와 함께 서버 검사기를 실행하려면:
npx @modelcontextprotocol/inspector uv --directory C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\polymarket-mcp run src/polymarket_mcp/server.pyPolyMarket API 키로
.env파일을 만듭니다.
Key=your_api_key_here
Funder=poly market wallet addressjson 파일을 통해 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: 과거 가격 및 거래량 데이터 가져오기
시장 정보 얻기
입력 스키마:
{
"market_id": {
"type": "string",
"description": "Market ID or slug"
}
}응답 예시:
Title: Example Market
Category: Politics
Status: Open
Resolution Date: 2024-12-31
Volume: $1,234,567.89
Liquidity: $98,765.43
Description: This is an example prediction market...
---목록 시장
입력 스키마:
{
"status": {
"type": "string",
"description": "Filter by market status",
"enum": ["open", "closed", "resolved"]
},
"limit": {
"type": "integer",
"description": "Number of markets to return",
"default": 10,
"minimum": 1,
"maximum": 100
},
"offset": {
"type": "integer",
"description": "Number of markets to skip (for pagination)",
"default": 0,
"minimum": 0
}
}응답 예시:
Available Markets:
ID: market-123
Title: US Presidential Election 2024
Status: Open
Volume: $1,234,567.89
---
ID: market-124
Title: Oscar Best Picture 2024
Status: Open
Volume: $234,567.89
---시장 가격 얻기
입력 스키마:
{
"market_id": {
"type": "string",
"description": "Market ID or slug"
}
}응답 예시:
Current Market Prices for US Presidential Election 2024
Outcome: Democratic
Price: $0.6500
Probability: 65.0%
---
Outcome: Republican
Price: $0.3500
Probability: 35.0%
---시장 이력 가져오기
입력 스키마:
{
"market_id": {
"type": "string",
"description": "Market ID or slug"
},
"timeframe": {
"type": "string",
"description": "Time period for historical data",
"enum": ["1d", "7d", "30d", "all"],
"default": "7d"
}
}응답 예시:
Historical Data for US Presidential Election 2024
Time Period: 7d
Time: 2024-01-20T12:00:00Z
Price: $0.6500
Volume: $123,456.78
---
Time: 2024-01-19T12:00:00Z
Price: $0.6300
Volume: $98,765.43
---오류 처리
서버에는 다양한 시나리오에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.
속도 제한(429 오류)
잘못된 API 키(403 오류)
잘못된 시장 ID(404 오류)
네트워크 연결 문제
API 타임아웃 조건(30초 타임아웃)
잘못된 응답
오류 메시지는 사람이 읽을 수 있는 명확한 형식으로 반환됩니다.
필수 조건
파이썬 3.9 이상
httpx>=0.24.0
mcp-코어
파이썬-dotenv>=1.0.0
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요. 주요 변경 사항의 경우, 먼저 이슈를 열어 변경 사항을 논의해 주세요.