bithumb-ai-kit

AI 에이전트(Claude, Gemini, GPT)에서 빗썸 거래소 API를 직접 호출할 수 있는 MCP 서버입니다.

설치

npm install -g bithumb-ai-kit

빠른 시작

1. AI 클라이언트에 MCP 서버 등록

Claude Code:

claude mcp add bithumb-ai-kit -- npx bithumb-ai-kit

Gemini CLI:

gemini mcp add bithumb-ai-kit -- npx bithumb-ai-kit

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "bithumb": {
      "command": "npx",
      "args": ["bithumb-ai-kit"]
    }
  }
}

2. 시세 조회 (API 키 불필요)

설치만 하면 바로 사용 가능합니다:

> 빗썸에서 KRW-BTC 현재가 조회해줘
> 비트코인 호가창 보여줘
> 이더리움 최근 거래 내역 알려줘

3. 잔고/주문 조회 (API 키 필요)

빗썸 계정의 Private API를 사용하려면 환경변수를 설정하세요:

export BITHUMB_ACCESS_KEY=your_access_key
export BITHUMB_SECRET_KEY=your_secret_key

Windows (PowerShell):

$env:BITHUMB_ACCESS_KEY="your_access_key"
$env:BITHUMB_SECRET_KEY="your_secret_key"

또는 MCP 클라이언트 설정에서 env를 추가:

{
  "mcpServers": {
    "bithumb": {
      "command": "npx",
      "args": ["bithumb-ai-kit"],
      "env": {
        "BITHUMB_ACCESS_KEY": "your_access_key",
        "BITHUMB_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

IP 등록 필수: 빗썸 Private API는 허용된 IP에서만 호출 가능합니다. 빗썸 API 관리 페이지에서 본인 PC의 공인 IP를 등록하세요.

사용 가능한 도구

Public (API 키 불필요)

| 도구 | 설명 | |------|------| | get-ticker | 현재가 조회 | | get-orderbook | 호가창 조회 | | get-transaction-history | 최근 거래 내역 | | get-candlestick | 캔들차트 데이터 |

Private (API 키 필요)

| 도구 | 설명 | |------|------| | get-balance | 전체 계좌 잔고 조회 | | get-assets-status | 자산 상태 조회 | | get-deposit-addresses | 입금 주소 조회 | | get-deposit | 개별 입금 조회 | | get-order | 개별 주문 조회 | | get-orders | 주문 목록 조회 |

요구사항

• Node.js 18 이상
• 빗썸 계정 및 API 키 (Private 도구 사용 시)

문제 해결

"Missing Bithumb private API credentials" 에러

BITHUMB_ACCESS_KEY와 BITHUMB_SECRET_KEY 환경변수가 설정되지 않았습니다. 위의 설정 방법을 참고하세요.

Private API 호출 시 인증 실패

빗썸 API 관리 페이지에서 본인 PC의 공인 IP가 등록되어 있는지 확인하세요.

서버가 응답하지 않음

MCP 서버는 stdio 모드로 동작하며, AI 클라이언트가 연결해야 활성화됩니다. 터미널에서 직접 실행하면 대기 상태로 보일 수 있습니다.

라이선스

MIT