Upbit MCP Server

Upbit MCP 服务

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

功能

• 获取市场数据（行情、订单簿、交易、K 线数据）
• 账户信息（余额、订单历史）
• 创建和取消订单
• 存款和取款功能
• 技术分析工具

可执行功能列表

查询市场数据

• 查询当前加密货币行情（get_ticker）
• 查询订单簿信息（get_orderbook）
• 查询最近成交记录（get_trades）
• 查看主要加密货币市场摘要信息（get_market_summary）

查询账户信息

• 查看持有的资产列表和余额（get_accounts）
• 查询订单记录（get_orders）
• 查询特定订单的详细信息（get_order）
• 查询存取款记录（get_deposits_withdrawals）

交易功能

• 创建限价/市价买入订单（create_order）
• 创建限价/市价卖出订单（create_order）
• 取消订单（cancel_order）

聊天示例

以下为实际聊天示例图片。

前置条件

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

1. 如果还没有账户，请在 Upbit 注册
2. 前往 Upbit Developer Center
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 可以加快安装速度，并更可靠地解析依赖项。

   # 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
   

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

   UPBIT_ACCESS_KEY=your_access_key_here
   UPBIT_SECRET_KEY=your_secret_key_here
   

使用方法

在 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": "/full/path/to/upbit-mcp-server/.venv/bin/python",
         "args": [
           "/full/path/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