Upbit MCP Server

🚀 Upbit MCP 服務器

本項目是一個基於模型上下文協議（MCP）實現的 Upbit 加密貨幣交易所 OpenAPI 服務端。它提供了一系列與 Upbit 交易所服務交互的工具，可用於檢索市場數據（如報價、訂單簿、交易歷史、圖表數據）、獲取賬戶信息、創建和取消訂單、管理資金存入與取出，還能執行技術分析。

🚀 快速開始

在開始使用本項目之前，您需要完成以下準備工作：

• 註冊 Upbit 賬戶。
• 獲取 API 密鑰（包含訪問密鑰、秘密密鑰和簽名密鑰）。
• 安裝 Python 以及其他必要的依賴項。
• 配置環境變量以存儲 API 密鑰。

✨ 主要特性

• 市場數據檢索：可獲取 ticker、orderbook、trades、candle 等數據。
• 賬戶信息查詢：能查看餘額、訂單歷史等信息。
• 訂單管理：支持創建和取消訂單。
• 資金管理：具備存款和取款功能。
• 技術分析工具：提供相關技術分析能力。

可執行的功能列表

市場數據查詢

• 當前加密貨幣價格查詢（get_ticker）
• 訂單簿信息查詢（get_orderbook）
• 最近成交記錄查詢（get_trades）
• 主要加密貨幣市場摘要信息查看（get_market_summary）

賬戶信息查詢

• 持有的資產列表及餘額確認（get_accounts）
• 訂單歷史記錄查詢（get_orders）
• 特定訂單詳細信息查詢（get_order）
• 存款和取款記錄查詢（get_deposits_withdrawals）

交易功能

• 限價/市價買入訂單創建（create_order）
• 限價/市價賣出訂單創建（create_order）
• 訂單取消（cancel_order）

聊天示例

下面是實際聊天示例的圖片。

📦 安裝指南

克隆倉庫

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

創建虛擬環境並安裝依賴項

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

配置 API 密鑰

編輯 config.py 文件，添加以下內容：

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

啟動服務器

uv run python main.py

📚 詳細文檔

注意事項

⚠️ 重要提示

該服務器可以處理真實交易，因此請謹慎使用。

💡 使用建議

請務必保持 API 密鑰的安全性，絕不要將它們提交到公共倉庫。

📄 許可證

本項目採用 MIT 許可證。