MAX Exchange MCP Server

Model Context Protocol (MCP)를 통해 MAX 거래소 API를 Claude와 같은 AI 어시스턴트에 통합하여, AI가 직접 시세를 조회하고 계정을 관리하며 주문을 실행할 수 있도록 합니다.

사전 요구 사항

Python 3.11+
MAX 거래소 계정 및 API 키 (신청하러 가기)

설치 및 실행

방법 1: uvx 직접 사용 (권장)

수동 설치 없이 GitHub에서 직접 실행:

uvx --from git+https://github.com/nicky512500/max-mcp maxmcp

방법 2: 로컬 설치

git clone https://github.com/nicky512500/max-mcp
cd max-mcp
pip install -e .
maxmcp

환경 변수 설정

MAX API 키를 제공해야 하며, 두 가지 방식을 지원합니다:

방식 1: .env 파일 (권장)

프로젝트 루트 디렉토리에 .env 파일을 생성합니다:

MAX_API_KEY=your_access_key
MAX_API_SECRET=your_secret_key

방식 2: 시스템 환경 변수

export MAX_API_KEY=your_access_key
export MAX_API_SECRET=your_secret_key

공개 조회 기능(시세, K-라인 등)은 API 키가 필요하지 않습니다.

Claude Desktop에서 사용

Claude Desktop 설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json)을 편집합니다:

{
  "mcpServers": {
    "max-exchange": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nicky512500/max-mcp", "maxmcp"],
      "env": {
        "MAX_API_KEY": "your_access_key",
        "MAX_API_SECRET": "your_secret_key"
      }
    }
  }
}

Claude Desktop을 재시작하면 사용할 수 있습니다.

Claude Code에서 사용

claude mcp add max-exchange -- uvx --from git+https://github.com/nicky512500/max-mcp maxmcp

사용 가능한 기능 목록

공개 정보 (API 키 불필요)

도구	설명
`get_markets`	모든 사용 가능한 거래 시장 목록 조회
`get_currencies`	모든 사용 가능한 통화 목록 조회
`get_timestamp`	MAX 서버 현재 시간 조회
`get_ticker`	단일 시장 실시간 시세 조회 (최신가, 매수/매도 호가, 24시간 거래량)
`get_tickers`	다중 시장 실시간 시세 조회 (한 번에 여러 개 조회 가능)
`get_depth`	시장 깊이(호가창) 조회, 최대 300건
`get_public_trades`	시장 최근 공개 체결 기록 조회
`get_k`	K-라인(캔들 차트) 데이터 조회, 다양한 주기 지원

K-라인 주기 (분): 1 / 5 / 15 / 30 / 60 / 120 / 240 / 360 / 720 / 1440

M-월렛 공개 정보 (API 키 불필요)

도구	설명
`get_m_index_prices`	M-월렛 각 통화별 지수 가격 조회
`get_m_limits`	M-월렛 사용 가능한 대출 한도 조회
`get_m_interest_rates`	M-월렛 각 통화별 대출 이자율 조회

계정 관리 (API 키 필요)

도구	설명
`get_user_info`	계정 정보 조회 (KYC 상태, 계정 ID 등)
`get_accounts`	계정별 통화 잔액 조회 (현물 또는 M-월렛)
`get_deposit_address`	지정된 통화의 입금 주소 조회
`get_withdraw_addresses`	등록된 출금 주소 목록 조회

주문 관리 (API 키 필요)

도구	설명
`submit_order`	매수/매도 주문 제출
`get_open_orders`	현재 미체결 주문 목록 조회
`get_closed_orders`	종료된 주문 조회 (체결 완료, 취소 등)
`get_orders_history`	ID 순서에 따른 주문 내역 페이지 조회
`get_order`	단일 주문 상세 조회
`cancel_order`	단일 주문 취소
`cancel_orders`	특정 시장의 주문 일괄 취소

주문 유형 (ord_type): limit / market / stop_limit / stop_market / post_only / ioc_limit

체결 기록 (API 키 필요)

도구	설명
`get_trades`	개인 체결 내역 조회
`get_order_trades`	특정 주문의 모든 체결 상세 내역 조회

간편 교환 (API 키 필요)

도구	설명
`submit_convert`	통화 간편 교환 실행 (즉시 환전)
`get_convert`	단일 간편 교환 상세 조회
`get_converts`	간편 교환 내역 조회

입출금 (API 키 필요)

도구	설명
`submit_withdrawal`	암호화폐 출금 신청 제출
`submit_twd_withdrawal`	대만 달러(TWD) 출금 신청 제출
`get_withdrawal`	단일 출금 상세 조회
`get_withdrawals`	출금 내역 조회
`get_deposit`	단일 입금 상세 조회
`get_deposits`	입금 내역 조회
`get_internal_transfers`	플랫폼 내부 이체 기록 조회 (MAX 사용자 간 이체)
`get_rewards`	보상 기록 조회 (리베이트, 에어드랍, 이자 보상 등)

M-월렛 (API 키 필요)

도구	설명
`get_m_ad_ratio`	M-월렛 AD 비율(자산/대출) 조회, 임계값 미만 시 청산 발생
`submit_m_loan`	M-월렛 대출 신청
`get_m_loans`	M-월렛 대출 내역 조회
`submit_m_transfer`	현물 지갑과 M-월렛 간 자금 이체
`get_m_transfers`	M-월렛 자금 이체 기록 조회
`submit_m_repayment`	M-월렛 대출 상환
`get_m_repayments`	M-월렛 상환 내역 조회
`get_m_liquidations`	M-월렛 청산 내역 조회
`get_m_liquidation`	단일 M-월렛 청산 상세 조회
`get_m_interests`	M-월렛 이자 계산 내역 조회

사용 예시

Claude에서 자연어로 직접 질문:

查詢 BTC/USDT 目前的價格

幫我看一下我的現貨帳戶餘額

查詢 btcusdt 最近 10 根 1 小時 K 線

幫我在 btcusdt 以限價 90000 掛買單 0.001 BTC

取消 btcusdt 所有未成交的買單

주의사항

출금, 주문 등은 되돌릴 수 없는 작업이므로 매개변수를 확인한 후 실행하십시오.
API 키는 안전하게 보관하고 버전 관리 시스템에 커밋하지 마십시오.
M-월렛은 레버리지 대출을 포함하므로 청산 위험을 피하기 위해 AD 비율을 확인하십시오.

MAX Exchange MCP Server

MAX Exchange MCP Server

사전 요구 사항

설치 및 실행

방법 1: uvx 직접 사용 (권장)

방법 2: 로컬 설치

환경 변수 설정

Claude Desktop에서 사용

Claude Code에서 사용

사용 가능한 기능 목록

공개 정보 (API 키 불필요)

M-월렛 공개 정보 (API 키 불필요)

계정 관리 (API 키 필요)

주문 관리 (API 키 필요)

체결 기록 (API 키 필요)

간편 교환 (API 키 필요)

입출금 (API 키 필요)

M-월렛 (API 키 필요)

사용 예시

주의사항

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API