업비트 MCP 서버

모델 컨텍스트 프로토콜(MCP)을 사용하는 업비트 암호화폐 거래소 OpenAPI 서버 구현입니다. 이 프로젝트는 시장 데이터(호가, 주문장, 거래 내역, 차트 데이터), 계좌 정보 검색, 주문 생성 및 취소, 입출금 관리, 기술적 분석 수행 등 업비트 거래소 서비스와 연동하는 도구를 제공합니다.

특징

• 시장 데이터 검색(티커, 주문장, 거래, 캔들 데이터)

• 계좌정보(잔액, 주문내역)

• 주문 생성 및 취소

• 입금 및 출금 기능

• 기술 분석 도구

Related MCP server: MCP Bitget Trading Server

필수 조건

시작하기 전에 Upbit API 키를 받아야 합니다.

1. 아직 Upbit 계정이 없다면 계정을 만드세요

2. 업비트 개발자 센터 로 이동

3. 새로운 API 키 생성

4. 적절한 권한(필요에 따라 읽기, 거래, 인출)을 설정하세요.

5. API 키( UPBIT_ACCESS_KEY , UPBIT_SECRET_KEY )를 .env 파일에 저장합니다(설치 섹션 참조)

설치

1. 저장소를 복제합니다.

   지엑스피1

2. 종속성 설치:

   cd upbit-mcp-server
   uv sync

   아직 uv 설치되지 않았다면 다음과 같이 설치할 수 있습니다.

   uv 사용하면 설치가 더 빠르고 종속성 해결이 더 안정적입니다.

   # Install uv
   curl -Ls https://astral.sh/uv/install.sh | sh
   
    # Add uv to your PATH
   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc  # or bashrc, depending on your shell

3. 환경 변수 설정: 프로젝트 루트에 .env 파일을 만들고 Upbit API 키를 추가하세요.

   UPBIT_ACCESS_KEY=your_access_key_here
   UPBIT_SECRET_KEY=your_secret_key_here

용법

Claude Desktop에 설치

옵션 1: Claude 구성 파일 사용(직접 통합)

MCP 서버를 Claude의 구성 파일에 직접 추가할 수 있습니다.

1. Claude Desktop 설치

2. Claude Desktop 구성에 다음을 추가하세요.

   • macOS: ``~/라이브러리/애플리케이션 지원/클로드/클로드_데스크탑_config.json`

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 다음 구성을 추가합니다(필요에 따라 경로를 조정합니다):

   {
     "mcpServers": {
       "upbit-mcp-server": {
         "command": "/full/path/to/upbit-mcp-server/.venv/bin/python",
         "args": [
           "/full/path/to/upbit-mcp-server/main.py"
         ]
       }
     }
   }

4. 새로운 구성을 로드하려면 Claude를 다시 시작하세요.

옵션 2: fastmcp 사용

fastmcp install main.py --name "Upbit API"

Python으로 직접 실행

uv run python main.py

개발 모드(웹 인터페이스)

fastmcp dev main.py

주의

• 이 서버는 실제 거래를 처리할 수 있으므로 주의해서 사용하세요.

• API 키를 안전하게 보관하고 공개 저장소에 절대 커밋하지 마세요.

특허

MIT