Upbit MCP Server

🚀 Upbit MCP Server

An OpenAPI server for the Upbit cryptocurrency exchange implemented using the Model Context Protocol (MCP). This project provides tools for interacting with Upbit exchange services, such as retrieving market data (quotes, order books, trading history, chart data), account information, creating and canceling orders, managing deposits/withdrawals, and performing technical analysis.

🚀 Quick Start

Before you start, you need to complete the following steps:

• Register an Upbit account.
• Obtain API keys (access key, secret key, and signature key).
• Install Python and other necessary dependencies.
• Configure environment variables to store the API keys.

✨ Features

• Market data retrieval (ticker, orderbook, trades, candle data)
• Account information (balances, order history)
• Order creation and cancellation
• Deposit and withdrawal functions
• Technical analysis tools

📦 Installation

1. Clone the repository:

git clone https://github.com/yourusername/upbit-mcp-server.git
cd upbit-mcp-server

2. Create a virtual environment and install dependencies:

python -m venv .venv
source .venv/bin/activate  # On Unix/MacOS
pip install -r requirements.txt

3. Configure API keys: Edit the config.py file and add the following content:

API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"
SIGNATURE_KEY = "your_signature_key"

4. Start the server:

uv run python main.py

💻 Usage Examples

Basic Usage

# Clone the repository
git clone https://github.com/yourusername/upbit-mcp-server.git
cd upbit-mcp-server

# Create a virtual environment and install dependencies
python -m venv .venv
source .venv/bin/activate  # On Unix/MacOS
pip install -r requirements.txt

# Configure API keys
edit config.py
API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"
SIGNATURE_KEY = "your_signature_key"

# Start the server
uv run python main.py

📄 License

This project is licensed under the MIT License.

⚠️ Important Note

This server can handle real trades, so please use it with caution.

💡 Usage Tip

Keep your API keys secure and never commit them to a public repository.