solangii/upbit-mcp-server

A server implementation for Upbit Cryptocurrency Exchange OpenAPI using the Model Context Protocol (MCP). This project provides tools to interact with Upbit exchange services, such as retrieving market data (quotes, orderbooks, trade history, chart data), account information, creating and canceling orders, managing deposits/withdrawals, and performing technical analysis.
Features
- Market data retrieval (ticker, orderbook, trades, candle data)
- Account information (balance, order history)
- Order creation and cancellation
- Deposit and withdrawal functions
- Technical analysis tools
수행가능한 기능 목록
시장 데이터 조회
현재 암호화폐 시세 조회 ( get_ticker )
호가창 정보 조회 ( get_orderbook )
최근 체결 내역 조회 ( get_trades )
주요 암호화폐 시장 요약 정보 확인 ( get_market_summary )
계정 정보 조회
보유 중인 자산 목록 및 잔고 확인 ( get_accounts )
주문 내역 조회 ( get_orders )
특정 주문 상세 정보 조회 ( get_order )
입출금 내역 조회 ( get_deposits_withdrawals )
거래 기능
지정가/시장가 매수 주문 생성 ( create_order )
지정가/시장가 매도 주문 생성 ( create_order )
주문 취소 ( cancel_order )
채팅 예시
아래는 실제 채팅 예시 이미지입니다.
Prerequisites
Before you begin, you need to get your Upbit API keys:
1. Create an account on Upbit if you don't already have one
2. Go to the Upbit Developer Center
3. Create a new API key
4. Make sure to set appropriate permissions (read, trade, withdraw as needed)
5. Store your API keys(UPBIT_ACCESS_KEY, UPBIT_SECRET_KEY) in the .env file (see Installation section)
Installation
1. Clone the repository:
2. Install dependencies:
If you don't have uv installed yet, you can install it as follows:
Using uv provides faster installation and more reliable dependency resolution.
3. Set up environment variables:
Create a .env file in the project root and add your Upbit API keys:
Usage
Install in Claude Desktop
Option 1: Using Claude config file (Direct integration)
You can add the MCP server directly to Claude's configuration file:
1. Install Claude Desktop
2. Add the following to your Claude Desktop configuration:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json`
3. Add the following configuration (adjust paths as needed):
4. Restart Claude to load the new configuration.