Polymarket MCP 서버

⚠️ 공지: Quantish가 종료됩니다. Quantish 플랫폼(quantish.live)이 종료됩니다. 이 MCP 서버는 자체 호스팅되며 독립적으로 계속 작동하지만, Quantish 팀은 더 이상 이 프로젝트를 유지보수하거나 업데이트하지 않습니다. 예측 시장 분야에서 실시간 데이터 인프라가 필요하다면 polynode.dev를 확인하세요.

Polygon 네트워크를 통해 Polymarket 예측 시장에서 거래할 수 있는 자체 호스팅 MCP 서버입니다.

개요

이 패키지는 AI 에이전트가 Polygon 네트워크를 통해 Polymarket 예측 시장에서 거래할 수 있도록 하는 MCP(Model Context Protocol) 서버를 제공합니다.

Related MCP server: polymarket-mcp

기능

• 전체 Polymarket 거래 - 모든 Polymarket 시장에서 매수/매도

• Polygon 지갑 관리 - Safe 통합을 통한 지갑 생성 및 관리

• 가스 없는 트랜잭션 - 대부분의 작업은 Polymarket의 릴레이어 사용(MATIC 불필요)

• MCP 호환 - Claude, Cursor 및 모든 MCP 클라이언트와 작동

• 자체 호스팅 가능 - Railway, Fly.io 또는 모든 Node.js 호스트에서 실행 가능

빠른 시작

git clone https://github.com/joinQuantish/polymarket-mcp
cd polymarket-mcp
npm install

환경 변수

암호화 키 생성

# Generate ENCRYPTION_KEY (32 bytes = 64 hex chars)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# Generate BOT_SIGNING_SECRET (for trusted bot auth)
node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

데이터베이스 설정

모든 PostgreSQL 데이터베이스가 작동합니다. 옵션:

DATABASE_URL을 설정한 후 다음을 실행하세요:

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

서버 실행

# Development
npm run dev

# Production
npm run build
npm start

사용 가능한 도구

계정 및 지갑

거래

포지션

전송 및 스왑

API 키

참고: 시장 검색 도구(search_markets, get_market, get_active_markets)는 Discovery MCP를 통해 사용할 수 있습니다.

API 형식

서버는 /mcp에서 JSON-RPC 2.0 엔드포인트를 노출합니다:

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_balances",
      "arguments": {}
    },
    "id": 1
  }'

MCP 클라이언트 설정

Claude Desktop / Cursor

{
  "mcpServers": {
    "polymarket": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-server.com/mcp",
        "--header",
        "x-api-key: YOUR_API_KEY"
      ]
    }
  }
}

보안

기존 사용자

보안을 위해 기존 사용자(기존 externalId)는 인증 없이 새 API 키를 받을 수 없습니다. 옵션:

1. 기존 API 키 사용 - 저장해 둔 경우

2. HMAC 인증(신뢰할 수 있는 봇 전용) - BOT_SIGNING_SECRET으로 서명:

   signature = HMAC-SHA256(externalId:timestamp, BOT_SIGNING_SECRET)

3. 새 계정 - 다른 externalId 사용

개발

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

리소스

• GitHub: joinQuantish/polymarket-mcp

• Discovery MCP: joinQuantish/quantish-discovery

• Polymarket 문서: docs.polymarket.com

라이선스

이 프로젝트는 PolyForm 비상업적 라이선스 1.0.0에 따라 라이선스가 부여됩니다.

개인 사용, 연구 및 비상업적 목적에 무료입니다. 상업적 사용은 Quantish Inc.의 명시적 허가가 필요합니다. 상업적 라이선스는 hello@quantish.live로 문의하세요.

Quantish Inc. 제작