upbit-mcp-server
If you are the rightful owner of upbit-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A server implementation for Upbit Cryptocurrency Exchange OpenAPI using the Model Context Protocol (MCP).
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:
- Create an account on Upbit if you don't already have one
- Go to the Upbit Developer Center
- Create a new API key
- Make sure to set appropriate permissions (read, trade, withdraw as needed)
- Store your API keys(
UPBIT_ACCESS_KEY,UPBIT_SECRET_KEY) in the.envfile (see Installation section)
Installation
-
Clone the repository:
git clone https://github.com/solangii/upbit-mcp-server.git cd upbit-mcp-server -
Install dependencies:
cd upbit-mcp-server uv syncIf you don't have
uvinstalled yet, you can install it as follows:Using
uvprovides faster installation and more reliable dependency resolution.# 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 -
Set up environment variables: Create a
.envfile in the project root and add your Upbit API keys:UPBIT_ACCESS_KEY=your_access_key_here UPBIT_SECRET_KEY=your_secret_key_here
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:
-
Install Claude Desktop
-
Add the following to your Claude Desktop configuration:
- macOS: ``~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
-
Add the following configuration (adjust paths as needed):
{ "mcpServers": { "upbit-mcp-server": { "command": "/full/path/to/upbit-mcp-server/.venv/bin/python", "args": [ "/full/path/to/upbit-mcp-server/main.py" ] } } } -
Restart Claude to load the new configuration.
Option 2: Using fastmcp
fastmcp install main.py --name "Upbit API"
Run Directly with Python
uv run python main.py
Development Mode (Web Interface)
fastmcp dev main.py
Caution
- This server can process real trades, so use it carefully.
- Keep your API keys secure and never commit them to public repositories.
License
MIT
