본문 바로가기
M MCP모아

MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.

빗썸 AI 트레이드 킷 MCP — 빗썸 시세·잔고 조회와 주문·입출금까지 다루는 공식 MCP, 실거래 주의

bithumb-official/bithumb-ai-trade-kit

빗썸 AI 트레이드 킷 MCP는 빗썸이 직접 배포하는 npx 로컬 서버로, 시세·잔고 조회와 주문·입출금을 지원하며 실거래 위험이 있어 --read-only 옵션을 제공합니다.

빗썸 공식 실험적 사용 주의 ⚖ MIT 보통 ★ 6 업데이트 5개월 전
Claude Code Cursor Cline Codex 호환

설치

터미널에서 실행하세요. 기본은 이 프로젝트 전용(local, ~/.claude.json)으로 저장됩니다. 팀과 공유하려면 --scope project(프로젝트 루트 .mcp.json), 모든 프로젝트에서 쓰려면 --scope user 를 붙이세요. 확인: claude mcp list 또는 Claude Code 세션 안에서 /mcp

claude mcp add -e 'BITHUMB_ACCESS_KEY=${BITHUMB_ACCESS_KEY}' -e 'BITHUMB_SECRET_KEY=${BITHUMB_SECRET_KEY}' bithumb -- npx -y @bithumb-official/bithumb-mcp --modules all

이 MCP가 해결하는 문제

암호화폐 거래소 API를 AI에 연결하면 시세 분석은 편해지지만 주문·출금 오작동은 곧바로 자산 손실이 됩니다. 이 서버는 기능을 모듈로 나눠 필요한 것만 노출하고, --read-only로 쓰기 도구를 막을 수 있게 합니다. 시세 조회는 키 없이 시작할 수 있습니다.

보안 점검

2026-11-16 점검
사용 주의

빗썸 공식 npm 패키지로 외부 전송 대상이 빗썸 API 하나뿐이었으나, 주문·출금 도구가 있어 실거래 위험이 크고 GitHub 저장소에는 MCP 소스가 없습니다.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 임의 셸 실행 없음
  • 제3자 서버 경유 없음
  • 자격증명 평문 저장 없음

유의사항

  • 공식 확인: GitHub 조직 bithumb-official(위치 Korea, 블로그 bithumb.com), npm 유지관리자 bithumb-npm([email protected]), 공식 개발자 문서(apidocs.bithumb.com)가 같은 패키지를 안내합니다. 패키지 최초 게시는 2026-05-29입니다.
  • GitHub 저장소(bithumb-ai-trade-kit)에는 문서와 Skills만 있고 MCP 소스는 없습니다. npm 0.8.5 배포본의 dist/index.js를 열람했으며(실행하지 않음) 호출 URL은 api.bithumb.com 하나, child_process·spawn·postinstall은 확인되지 않았고 의존성은 @modelcontextprotocol/sdk 하나입니다.
  • 주문, TWAP, 가상자산 출금, 원화 출금·입금 요청 도구가 있어 AI 오작동이 실제 자산 손실로 이어질 수 있습니다. --read-only로 쓰기를 차단할 수 있으며 확인한 MCP 문서 범위에서는 주문 전 별도 승인 단계가 서버에 내장돼 있다는 설명은 없었습니다.
  • 키는 BITHUMB_ACCESS_KEY·BITHUMB_SECRET_KEY 환경변수로만 받습니다. 도구 호출은 로컬 실행 로그에 기록되며 --no-log로 끌 수 있고, 빗썸은 출금 권한 부여를 권장하지 않는다고 면책 문서에 밝힙니다.
  • 빗썸 면책 문서는 AI를 통한 주문도 이상거래탐지(FDS)·AML 대상이며 이상 징후 시 API 키 사용이 제한될 수 있다고 안내합니다. MIT 라이선스입니다.

데이터·키 전송 대상

api.bithumb.com (빗썸 Open API)~/.bithumb/logs (로컬 실행 로그)

GitHub 저장소 직접 점검 — README·매니페스트(package.json/pyproject)·서버 소스·설치 스크립트·패키지 레지스트리(npm/PyPI/JSR) 대조. 공개 소스 기준의 자동+수동 검토 의견이며 완전성·무오류를 보증하지 않습니다. 시점 이후 변경될 수 있습니다.

한국어 사용 예시

코인 시세 조회

KRW-BTC 현재가와 최근 1시간봉 24개를 보여줘

내 잔고 확인

내 빗썸 계좌의 보유 자산과 KRW 잔고를 보여줘

미체결 주문 확인

내 미체결 주문 목록을 보여줘

자주 묻는 질문

API 키는 어떻게 발급하나요?

빗썸 API 관리 페이지(https://www.bithumb.com/react/api-support/management-api)에서 필요한 권한만 골라 발급하고 BITHUMB_ACCESS_KEY, BITHUMB_SECRET_KEY 환경변수로 설정합니다. 시세 조회 도구는 키 없이 쓸 수 있습니다.

AI가 실제 주문이나 출금을 할 수 있나요? 어떻게 막나요?

가능합니다. 주문, TWAP 주문, 입금, 출금 도구가 포함돼 있어 오작동이 실제 자산 손실로 이어질 수 있습니다. args에 --read-only를 넣으면 주문·입출금이 차단되고 --modules market,account처럼 모듈을 제한할 수 있습니다. 빗썸 면책 안내는 출금 권한 부여를 권장하지 않으며 최종 주문 전 사용자 승인 절차를 둘 것을 권고합니다.

어떤 클라이언트에서 쓰나요? 공식 문서는요?

공식 문서(https://apidocs.bithumb.com/docs/mcp)에 Claude Code, Codex, Cursor, VS Code, Windsurf, Claude Desktop 설정이 안내돼 있고 npx로 로컬 실행합니다. 같은 저장소에는 CLI(@bithumb-official/bithumb-cli)와 에이전트용 Skills도 함께 있습니다.

연동 API

빗썸 Open API

관련 MCP

한국투자증권 트레이딩 MCP

koreainvestment/open-trading-api

공식 실험적 사용 주의

한국투자증권 공식 OPEN API 기반 국내외 주식·선물옵션 시세·잔고·주문 MCP 서버

금융·DART·주식 한국투자증권 OPEN APIKIS Developers API 키 필요
★ 1,677 ↓ 80/주 2일 전
Claude Code Cursor Cline

토스증권 CLI·MCP (tossctl)

JungHoonGhae/tossinvest-cli

실험적 사용 주의

토스증권 비공식 CLI·MCP — 공식 Open API와 웹 내부 API로 시세·자산·주문 조회

금융·DART·주식 토스증권 Open API토스증권 WTS(웹 내부 API) API 키 필요
★ 522 2일 전
Claude Code Cursor Cline

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.

아직 후기가 없습니다. 첫 후기를 남겨주세요!