Servidor MCP de MAX Exchange

A través del Model Context Protocol (MCP), integra la API de MAX Exchange con asistentes de IA como Claude, permitiendo que la IA consulte precios, gestione cuentas y realice operaciones de trading directamente.

Requisitos previos

Python 3.11+
Cuenta de MAX Exchange y clave API (Solicitar aquí)

Instalación y ejecución

Método 1: Usar uvx directamente (recomendado)

No requiere instalación manual, ejecútelo directamente desde GitHub:

uvx --from git+https://github.com/nicky512500/max-mcp maxmcp

Método 2: Instalación local

git clone https://github.com/nicky512500/max-mcp
cd max-mcp
pip install -e .
maxmcp

Configuración de variables de entorno

Es necesario proporcionar la clave API de MAX, se admiten dos formas:

Forma 1: Archivo .env (recomendado)

Cree un archivo .env en el directorio raíz del proyecto:

MAX_API_KEY=your_access_key
MAX_API_SECRET=your_secret_key

Forma 2: Variables de entorno del sistema

export MAX_API_KEY=your_access_key
export MAX_API_SECRET=your_secret_key

Las funciones de consulta pública (precios, velas, etc.) no requieren clave API.

Uso en Claude Desktop

Edite el archivo de configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "max-exchange": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nicky512500/max-mcp", "maxmcp"],
      "env": {
        "MAX_API_KEY": "your_access_key",
        "MAX_API_SECRET": "your_secret_key"
      }
    }
  }
}

Reinicie Claude Desktop para comenzar a usarlo.

Uso en Claude Code

claude mcp add max-exchange -- uvx --from git+https://github.com/nicky512500/max-mcp maxmcp

Resumen de funciones disponibles

Información pública (sin clave API)

Herramienta	Descripción
`get_markets`	Obtiene la lista de todos los mercados de trading disponibles
`get_currencies`	Obtiene la lista de todas las monedas disponibles
`get_timestamp`	Obtiene la hora actual del servidor de MAX
`get_ticker`	Obtiene el precio en tiempo real de un mercado (precio actual, mejor oferta/demanda, volumen 24h)
`get_tickers`	Obtiene precios en tiempo real de múltiples mercados (se pueden consultar varios a la vez)
`get_depth`	Obtiene la profundidad del mercado (libro de órdenes), hasta 300 registros
`get_public_trades`	Obtiene los registros de operaciones públicas recientes del mercado
`get_k`	Obtiene datos de velas (gráficos de velas), soporta múltiples periodos

Periodos de velas (minutos): 1 / 5 / 15 / 30 / 60 / 120 / 240 / 360 / 720 / 1440

Información pública de M-wallet (sin clave API)

Herramienta	Descripción
`get_m_index_prices`	Obtiene los precios índice de cada moneda en M-wallet
`get_m_limits`	Obtiene los límites de crédito disponibles en M-wallet
`get_m_interest_rates`	Obtiene las tasas de interés de préstamo de cada moneda en M-wallet

Gestión de cuentas (requiere clave API)

Herramienta	Descripción
`get_user_info`	Obtiene información de la cuenta (estado KYC, ID de cuenta, etc.)
`get_accounts`	Obtiene los saldos de cada moneda en la cuenta (al contado o M-wallet)
`get_deposit_address`	Obtiene la dirección de depósito para una moneda específica
`get_withdraw_addresses`	Obtiene la lista de direcciones de retiro vinculadas

Gestión de órdenes (requiere clave API)

Herramienta	Descripción
`submit_order`	Envía una orden de compra o venta
`get_open_orders`	Obtiene la lista de órdenes pendientes actuales
`get_closed_orders`	Obtiene órdenes cerradas (ejecutadas, canceladas, etc.)
`get_orders_history`	Obtiene el historial de órdenes paginado por ID
`get_order`	Consulta los detalles de una orden específica
`cancel_order`	Cancela una orden pendiente específica
`cancel_orders`	Cancela en lote las órdenes de un mercado

Tipos de orden (ord_type): limit / market / stop_limit / stop_market / post_only / ioc_limit

Historial de operaciones (requiere clave API)

Herramienta	Descripción
`get_trades`	Obtiene el historial personal de operaciones
`get_order_trades`	Obtiene los detalles de todas las operaciones de una orden específica

Conversión rápida (requiere clave API)

Herramienta	Descripción
`submit_convert`	Ejecuta una conversión de moneda (tipo de cambio instantáneo)
`get_convert`	Consulta los detalles de una conversión específica
`get_converts`	Obtiene el historial de conversiones

Depósitos y retiros (requiere clave API)

Herramienta	Descripción
`submit_withdrawal`	Envía una solicitud de retiro de criptomonedas
`submit_twd_withdrawal`	Envía una solicitud de retiro de TWD (dólar taiwanés)
`get_withdrawal`	Consulta los detalles de un retiro específico
`get_withdrawals`	Obtiene el historial de retiros
`get_deposit`	Consulta los detalles de un depósito específico
`get_deposits`	Obtiene el historial de depósitos
`get_internal_transfers`	Obtiene el historial de transferencias internas (entre usuarios de MAX)
`get_rewards`	Obtiene el historial de recompensas (comisiones, airdrops, intereses, etc.)

M-wallet (requiere clave API)

Herramienta	Descripción
`get_m_ad_ratio`	Obtiene el ratio AD de M-wallet (activos / préstamos), si cae por debajo del umbral se activará la liquidación
`submit_m_loan`	Solicita un préstamo en M-wallet
`get_m_loans`	Obtiene el historial de préstamos de M-wallet
`submit_m_transfer`	Transfiere fondos entre la billetera al contado y M-wallet
`get_m_transfers`	Obtiene el historial de transferencias de fondos de M-wallet
`submit_m_repayment`	Realiza un pago de préstamo en M-wallet
`get_m_repayments`	Obtiene el historial de pagos de préstamos de M-wallet
`get_m_liquidations`	Obtiene el historial de liquidaciones de M-wallet
`get_m_liquidation`	Obtiene los detalles de una liquidación específica de M-wallet
`get_m_interests`	Obtiene el historial de cargos por intereses de M-wallet

Ejemplos de uso

Pregunte directamente en lenguaje natural en Claude:

查詢 BTC/USDT 目前的價格

幫我看一下我的現貨帳戶餘額

查詢 btcusdt 最近 10 根 1 小時 K 線

幫我在 btcusdt 以限價 90000 掛買單 0.001 BTC

取消 btcusdt 所有未成交的買單

Notas importantes

Las operaciones como retiros y órdenes son irreversibles, por favor confirme los parámetros antes de ejecutarlas.
Mantenga sus claves API seguras, no las suba a sistemas de control de versiones.
M-wallet implica préstamos con apalancamiento, verifique el ratio AD para evitar riesgos de liquidación.

MAX Exchange MCP Server