Skip to main content
Glama
Upbit MCP Server

Upbit MCP Server

by solangii

Servidor MCP de Upbit

Implementación de servidor para la plataforma de intercambio de criptomonedas Upbit OpenAPI mediante el Protocolo de Contexto de Modelo (MCP). Este proyecto proporciona herramientas para interactuar con los servicios de Upbit, como la recuperación de datos de mercado (cotizaciones, libros de órdenes, historial de operaciones, datos de gráficos), información de cuentas, la creación y cancelación de órdenes, la gestión de depósitos y retiros, y la realización de análisis técnicos.

Características

  • Recuperación de datos de mercado (ticker, libro de órdenes, operaciones, datos de velas)

  • Información de la cuenta (saldo, historial de pedidos)

  • Creación y cancelación de pedidos

  • Funciones de depósito y retiro

  • Herramientas de análisis técnico

Related MCP server: MCP Bitget Trading Server

Prerrequisitos

Antes de comenzar, necesitas obtener tus claves API de Upbit:

  1. Crea una cuenta en Upbit si aún no tienes una

  2. Vaya al Centro de desarrolladores de Upbit

  3. Crear una nueva clave API

  4. Asegúrese de establecer los permisos adecuados (leer, intercambiar, retirar según sea necesario)

  5. Almacene sus claves API ( UPBIT_ACCESS_KEY , UPBIT_SECRET_KEY ) en el archivo .env (consulte la sección Instalación)

Instalación

  1. Clonar el repositorio:

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

    cd upbit-mcp-server
    uv sync

    Si aún no tienes instalado uv , puedes instalarlo de la siguiente manera:

    El uso de uv proporciona una instalación más rápida y una resolución de dependencias más confiable.

    # 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. Configurar variables de entorno: Cree un archivo .env en la raíz del proyecto y agregue sus claves API de Upbit:

    UPBIT_ACCESS_KEY=your_access_key_here
    UPBIT_SECRET_KEY=your_secret_key_here

Uso

Instalar en Claude Desktop

Opción 1: Usar el archivo de configuración de Claude (integración directa)

Puede agregar el servidor MCP directamente al archivo de configuración de Claude:

  1. Instalar Claude Desktop

  2. Agregue lo siguiente a su configuración de Claude Desktop:

    • macOS: ``~/Library/Application Support/Claude/claude_desktop_config.json`

    • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

  3. Agregue la siguiente configuración (ajuste las rutas según sea necesario):

    {
      "mcpServers": {
        "upbit-mcp-server": {
          "command": "/full/path/to/upbit-mcp-server/.venv/bin/python",
          "args": [
            "/full/path/to/upbit-mcp-server/main.py"
          ]
        }
      }
    }
  4. Reinicie Claude para cargar la nueva configuración.

Opción 2: Usar fastmcp

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

Ejecutar directamente con Python

uv run python main.py

Modo de desarrollo (interfaz web)

fastmcp dev main.py

Precaución

  • Este servidor puede procesar transacciones reales, así que úselo con cuidado.

  • Mantenga sus claves API seguras y nunca las envíe a repositorios públicos.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

10 tools
cancel_orderC
업비트에서 주문을 취소합니다.

Args:
    uuid (str): 취소할 주문의 UUID
    
Returns:
    dict: 취소 결과

Inputs: uuid (required).

create_orderA
업비트에 주문을 생성합니다.

Args:
    market (str): 마켓 코드 (예: KRW-BTC)
    side (str): 주문 종류 - bid(매수) 또는 ask(매도)
    ord_type (str): 주문 타입 - limit(지정가), price(시장가 매수), market(시장가 매도)
    volume (str, optional): 주문량 (지정가, 시장가 매도 필수)
    price (str, optional): 주문 가격 (지정가 필수, 시장가 매수 필수)
    
Returns:
    dict: 주문 결과

Inputs: market (required), side (required), ord_type (required), volume, +1 more.

get_accountsB
업비트 계정의 잔고 정보를 조회합니다.

Returns:
    list[dict]: 보유 중인 자산 목록

Inputs: no named parameters.

get_deposits_withdrawalsB
업비트 계정의 입출금 내역을 조회합니다.

Args:
    currency (str, optional): 통화 코드 (예: BTC)
    txid (str, optional): 거래 ID
    transaction_type (str): 거래 유형 - deposit(입금) 또는 withdraw(출금)
    page (int): 페이지 번호
    limit (int): 페이지당 결과 개수 (최대 100)
    
Returns:
    list[dict]: 입출금 내역

Inputs: currency, txid, transaction_type, page, +1 more.

get_market_summaryB
주요 암호화폐 시장의 요약 정보를 제공합니다.

Returns:
    dict: 주요 암호화폐 시장 요약 정보

Inputs: no named parameters.

get_orderC
업비트에서 특정 주문의 정보를 조회합니다.

Args:
    uuid (str, optional): 주문 UUID
    identifier (str, optional): 조회용 사용자 지정 값
    
Returns:
    dict: 주문 정보

Inputs: uuid, identifier.

get_orderbookC

Get orderbook snapshot for a given symbol

Inputs: symbol (required).

get_ordersA
업비트에서 주문 내역을 조회합니다.

Args:
    market (str, optional): 마켓 코드 (예: KRW-BTC)
    state (str): 주문 상태 - wait(대기), done(완료), cancel(취소)
    page (int): 페이지 번호
    limit (int): 페이지당 주문 개수 (최대 100)
    
Returns:
    list[dict]: 주문 내역

Inputs: market, state, page, limit.

get_tickerC

Get the latest ticker data from Upbit

Inputs: symbol (required).

get_tradesC

Get recent trade ticks for a symbol

Inputs: symbol (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific resources and actions in the Upbit cryptocurrency exchange domain. For example, create_order, cancel_order, get_order, and get_orders handle different aspects of order management without overlap, while get_accounts, get_deposits_withdrawals, get_market_summary, get_orderbook, get_ticker, and get_trades each focus on unique data retrieval functions. No tools appear to do the same thing, making selection unambiguous for an agent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, such as get_accounts, create_order, and cancel_order. This predictable naming convention enhances readability and usability, with no deviations or mixed styles observed across the toolset. The consistency supports easy identification and reduces cognitive load for agents.

    Tool Count5/5

    With 10 tools, the server is well-scoped for its purpose of interacting with the Upbit cryptocurrency exchange. Each tool earns its place by covering essential operations like account management, order handling, and market data retrieval. This count aligns with typical server sizes (3-15 tools) and avoids being too thin or heavy, providing comprehensive functionality without unnecessary complexity.

    Completeness4/5

    The tool surface offers near-complete coverage for the cryptocurrency exchange domain, including CRUD operations for orders (create, get, cancel, list), account and transaction management, and market data access. Minor gaps exist, such as the lack of tools for modifying orders or handling advanced trading features like stop-loss orders, but agents can work around these with the available tools. Overall, the set supports core workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables interaction with the Upbit cryptocurrency exchange through public market data tools and optional private trading tools. Supports getting ticker data, orderbooks, trades, account information, and executing trading operations through natural language.
      19
      16 npm
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Bitget cryptocurrency exchange for spot and futures trading. Supports real-time market data, order management, account balances, leverage control, and position tracking with demo trading capabilities.
      17
      6
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables interaction with the Bithumb cryptocurrency exchange API to fetch market data, manage account balances, and execute trading operations including limit orders, market orders, and withdrawals.
      19
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      Provides programmatic access to the Binance.US cryptocurrency exchange, enabling users to manage spot trading, wallet operations, and market data via natural language. It supports a wide range of features including order management, staking, sub-account transfers, and account history tracking.
      93
      26
      -