Upbit MCP Server

这是一个使用模型上下文协议（MCP）实现的Upbit加密货币交易所OpenAPI服务器。该项目提供了与Upbit交易所服务交互的工具，例如获取市场数据（报价、订单簿、交易历史、图表数据）、账户信息、创建和取消订单、管理存款/取款以及进行技术分析。

功能

• 市场数据检索（行情、订单簿、成交记录、蜡烛图数据）
• 账户信息（余额、订单历史）
• 订单创建和取消
• 存款和取款功能
• 技术分析工具

<details> <summary><strong>可执行功能列表</strong></summary> <br/> <h4>市场数据查询</h4> <ul> <li>当前加密货币价格查询 (<code>get_ticker</code>)</li> <li>订单簿信息查询 (<code>get_orderbook</code>)</li> <li>最近成交记录查询 (<code>get_trades</code>)</li> <li>主要加密货币市场概要信息确认 (<code>get_market_summary</code>)</li> </ul> <h4>账户信息查询</h4> <ul> <li>持有资产列表及余额确认 (<code>get_accounts</code>)</li> <li>订单历史查询 (<code>get_orders</code>)</li> <li>特定订单详细信息查询 (<code>get_order</code>)</li> <li>存取款记录查询 (<code>get_deposits_withdrawals</code>)</li> </ul> <h4>交易功能</h4> <ul> <li>限价/市价买入订单创建 (<code>create_order</code>)</li> <li>限价/市价卖出订单创建 (<code>create_order</code>)</li> <li>订单取消 (<code>cancel_order</code>)</li> </ul> </details> <details> <summary><strong>聊天示例</strong></summary> <br/> <p> 下面是实际聊天示例图像。 </p> <img src="./assets/img1.png" alt="示例1" width="600"/> <img src="./assets/img2.png" alt="示例2" width="600"/> </details>

使用前准备

在开始之前，您需要获取您的Upbit API密钥：

1. 如果您还没有账户，请在Upbit上创建一个账户
2. 前往Upbit开发者中心
3. 创建一个新的API密钥
4. 确保设置适当的权限（读取、交易、提现等）
5. 将您的API密钥（UPBIT_ACCESS_KEY，UPBIT_SECRET_KEY）存储在.env文件中（参见安装部分）

安装

1. 克隆仓库：

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

2. 安装依赖项：

   cd upbit-mcp-server
   uv sync
   

   如果您尚未安装uv，可以按照以下步骤安装：

   使用uv提供更快的安装和更可靠的依赖解析。

   # 安装uv
   curl -Ls https://astral.sh/uv/install.sh | sh
   
   # 将uv添加到您的PATH
   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc  # 或者根据您的shell使用bashrc
   

3. 设置环境变量： 在项目根目录下创建一个.env文件，并添加您的Upbit API密钥：

   UPBIT_ACCESS_KEY=您的访问密钥
   UPBIT_SECRET_KEY=您的秘密密钥
   

使用方法

在Claude Desktop中安装

方案1：使用Claude配置文件（直接集成）

您可以直接将MCP服务器添加到Claude的配置文件中：

1. 安装Claude Desktop

2. 向您的Claude Desktop配置添加以下内容：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. 添加以下配置（根据需要调整路径）：

   {
     "mcpServers": {
       "upbit-mcp-server": {
         "command": "/完整路径/to/upbit-mcp-server/.venv/bin/python",
         "args": [
           "/完整路径/to/upbit-mcp-server/main.py"
         ]
       }
     }
   }
   

4. 重启Claude以加载新配置。

方案2：使用fastmcp

fastmcp install main.py --name "Upbit API"

直接使用Python运行

uv run python main.py

开发模式（Web界面）

fastmcp dev main.py

注意事项

• 此服务器可以处理真实交易，因此请谨慎使用。
• 保护好您的API密钥，切勿将其提交到公共仓库。

许可证

MIT