加密货币交易API服务器

Upbit MCP Server是一个基于模型上下文协议(MCP)的加密货币交易所API服务器实现,提供市场数据查询、账户管理、订单交易和存取款功能。

  • by solangii
  • Python
  • 本地部署
  • 18 星标
  • 更新于
在 GitHub 查看 solangii/upbit-mcp-server

使用说明

Upbit MCP服务器

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

特性

  • 市场数据检索(股票行情、订单簿、交易、蜡烛数据)
  • 账户信息(余额、订单历史)
  • 订单创建和取消
  • 存款和取款功能
  • 技术分析工具
수행가능한 기능 목록

시장 데이터 조회

  • 현재 암호화폐 시세 조회 (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开发者中心
  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桌面中安装

选项1:使用Claude配置文件(直接集成)

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

  1. 安装 克劳德桌面

  2. 将以下内容添加到您的Claude Desktop配置中:

    • macOS:`~/库/应用程序支持/Claude/Claude_desktop_config json`
    • 窗户: %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密钥的安全,并且永远不要将它们提交到公共存储库。

许可证

麻省理工学院