🚀 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 许可证。