Upbit MCP Server
Upbit MCP サーバー
モデルコンテキストプロトコル(MCP)を使用したUpbit暗号通貨取引所OpenAPIのサーバー実装。このプロジェクトは、市場データ(相場、注文板、取引履歴、チャートデータ)の取得、アカウント情報の取得、注文の作成とキャンセル、入出金の管理、テクニカル分析の実行など、Upbit取引所のサービスと連携するためのツールを提供します。
特徴
市場データの取得(ティッカー、注文簿、取引、ローソク足データ)
アカウント情報(残高、注文履歴)
注文の作成とキャンセル
入金・出金機能
テクニカル分析ツール
Related MCP server: MCP Bitget Trading Server
前提条件
始める前に、Upbit API キーを取得する必要があります。
Upbitでアカウントをお持ちでない場合は作成してください
新しいAPIキーを作成する
適切な権限(必要に応じて読み取り、取引、引き出し)を設定してください
APIキー(
UPBIT_ACCESS_KEY、UPBIT_SECRET_KEY)を.envファイルに保存します(インストールセクションを参照)。
インストール
リポジトリをクローンします。
git clone https://github.com/solangii/upbit-mcp-server.git cd upbit-mcp-server依存関係をインストールします:
cd upbit-mcp-server uv syncuvがまだインストールされていない場合は、次のようにインストールできます。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環境変数を設定します。プロジェクト ルートに
.envファイルを作成し、Upbit API キーを追加します。UPBIT_ACCESS_KEY=your_access_key_here UPBIT_SECRET_KEY=your_secret_key_here
使用法
Claude Desktopにインストール
オプション 1: Claude 構成ファイルの使用 (直接統合)
MCP サーバーを Claude の構成ファイルに直接追加できます。
Claude Desktopをインストールする
Claude Desktop 構成に以下を追加します。
macOS: ``~/Library/Application Support/Claude/claude_desktop_config.json`
Windows:
%APPDATA%\Claude\claude_desktop_config.json
次の構成を追加します (必要に応じてパスを調整します)。
{ "mcpServers": { "upbit-mcp-server": { "command": "/full/path/to/upbit-mcp-server/.venv/bin/python", "args": [ "/full/path/to/upbit-mcp-server/main.py" ] } } }新しい構成をロードするには、Claude を再起動します。
オプション2: fastmcpを使用する
fastmcp install main.py --name "Upbit API"Pythonで直接実行
uv run python main.py開発モード(Webインターフェース)
fastmcp dev main.py注意
このサーバーは実際の取引を処理できるため、慎重に使用してください。
API キーを安全に保ち、パブリック リポジトリにコミットしないでください。
ライセンス
マサチューセッツ工科大学
Available Tools
10 toolscancel_orderC
업비트에서 주문을 취소합니다.
Args:
uuid (str): 취소할 주문의 UUID
Returns:
dict: 취소 결과
Inputs: uuid (required).
create_orderA
업비트에 주문을 생성합니다.
Args:
market (str): 마켓 코드 (예: KRW-BTC)
side (str): 주문 종류 - bid(매수) 또는 ask(매도)
ord_type (str): 주문 타입 - limit(지정가), price(시장가 매수), market(시장가 매도)
volume (str, optional): 주문량 (지정가, 시장가 매도 필수)
price (str, optional): 주문 가격 (지정가 필수, 시장가 매수 필수)
Returns:
dict: 주문 결과
Inputs: market (required), side (required), ord_type (required), volume, +1 more.
get_accountsB
업비트 계정의 잔고 정보를 조회합니다.
Returns:
list[dict]: 보유 중인 자산 목록
Inputs: no named parameters.
get_deposits_withdrawalsB
업비트 계정의 입출금 내역을 조회합니다.
Args:
currency (str, optional): 통화 코드 (예: BTC)
txid (str, optional): 거래 ID
transaction_type (str): 거래 유형 - deposit(입금) 또는 withdraw(출금)
page (int): 페이지 번호
limit (int): 페이지당 결과 개수 (최대 100)
Returns:
list[dict]: 입출금 내역
Inputs: currency, txid, transaction_type, page, +1 more.
get_market_summaryB
주요 암호화폐 시장의 요약 정보를 제공합니다.
Returns:
dict: 주요 암호화폐 시장 요약 정보
Inputs: no named parameters.
get_orderC
업비트에서 특정 주문의 정보를 조회합니다.
Args:
uuid (str, optional): 주문 UUID
identifier (str, optional): 조회용 사용자 지정 값
Returns:
dict: 주문 정보
Inputs: uuid, identifier.
get_orderbookC
Get orderbook snapshot for a given symbol
Inputs: symbol (required).
get_ordersA
업비트에서 주문 내역을 조회합니다.
Args:
market (str, optional): 마켓 코드 (예: KRW-BTC)
state (str): 주문 상태 - wait(대기), done(완료), cancel(취소)
page (int): 페이지 번호
limit (int): 페이지당 주문 개수 (최대 100)
Returns:
list[dict]: 주문 내역
Inputs: market, state, page, limit.
get_tickerC
Get the latest ticker data from Upbit
Inputs: symbol (required).
get_tradesC
Get recent trade ticks for a symbol
Inputs: symbol (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose targeting specific resources and actions in the Upbit cryptocurrency exchange domain. For example, create_order, cancel_order, get_order, and get_orders handle different aspects of order management without overlap, while get_accounts, get_deposits_withdrawals, get_market_summary, get_orderbook, get_ticker, and get_trades each focus on unique data retrieval functions. No tools appear to do the same thing, making selection unambiguous for an agent.
All tool names follow a consistent verb_noun pattern using snake_case, such as get_accounts, create_order, and cancel_order. This predictable naming convention enhances readability and usability, with no deviations or mixed styles observed across the toolset. The consistency supports easy identification and reduces cognitive load for agents.
With 10 tools, the server is well-scoped for its purpose of interacting with the Upbit cryptocurrency exchange. Each tool earns its place by covering essential operations like account management, order handling, and market data retrieval. This count aligns with typical server sizes (3-15 tools) and avoids being too thin or heavy, providing comprehensive functionality without unnecessary complexity.
The tool surface offers near-complete coverage for the cryptocurrency exchange domain, including CRUD operations for orders (create, get, cancel, list), account and transaction management, and market data access. Minor gaps exist, such as the lack of tools for modifying orders or handling advanced trading features like stop-loss orders, but agents can work around these with the available tools. Overall, the set supports core workflows effectively.
Maintenance
Related MCP Connectors
Binance - 340 tools for market data, order books, and trading pairs
Market analyst tools + AI agent: crypto, US equities, options, Korea, fundamentals, macro, backtests
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
AI agent access to Asian crypto markets. Korean exchange routing and x402 paid APIs.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with the Upbit cryptocurrency exchange through public market data tools and optional private trading tools. Supports getting ticker data, orderbooks, trades, account information, and executing trading operations through natural language.1916 npm2MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Bitget cryptocurrency exchange for spot and futures trading. Supports real-time market data, order management, account balances, leverage control, and position tracking with demo trading capabilities.176MIT
- AlicenseBqualityDmaintenanceEnables interaction with the Bithumb cryptocurrency exchange API to fetch market data, manage account balances, and execute trading operations including limit orders, market orders, and withdrawals.19MIT
- FlicenseBqualityBmaintenanceProvides programmatic access to the Binance.US cryptocurrency exchange, enabling users to manage spot trading, wallet operations, and market data via natural language. It supports a wide range of features including order management, staking, sub-account transfers, and account history tracking.9326-