MCP-сервер MAX Exchange

Интегрируйте API биржи MAX с ИИ-ассистентами, такими как Claude, через Model Context Protocol (MCP), чтобы ИИ мог запрашивать рыночные данные, управлять счетами и совершать сделки.

Предварительные требования

Python 3.11+
Аккаунт на бирже MAX и API-ключ (подать заявку)

Установка и запуск

Способ 1: Использование uvx (рекомендуется)

Не требует ручной установки, запуск напрямую из GitHub:

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

Способ 2: Локальная установка

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

Настройка переменных окружения

Необходимо предоставить API-ключ MAX, поддерживаются два способа:

Способ 1: Файл .env (рекомендуется)

Создайте файл .env в корне проекта:

MAX_API_KEY=your_access_key
MAX_API_SECRET=your_secret_key

Способ 2: Системные переменные окружения

export MAX_API_KEY=your_access_key
export MAX_API_SECRET=your_secret_key

Функции публичного запроса (рыночные данные, графики и т.д.) не требуют API-ключа.

Использование в Claude Desktop

Отредактируйте файл конфигурации 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"
      }
    }
  }
}

После перезапуска Claude Desktop функции станут доступны.

Использование в Claude Code

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

Обзор доступных функций

Публичная информация (API-ключ не требуется)

Инструмент	Описание
`get_markets`	Получить список всех доступных торговых рынков
`get_currencies`	Получить список всех доступных валют
`get_timestamp`	Получить текущее время сервера MAX
`get_ticker`	Получить рыночные данные в реальном времени для одного рынка (последняя цена, цена покупки/продажи, объем за 24ч)
`get_tickers`	Получить рыночные данные в реальном времени для нескольких рынков
`get_depth`	Получить глубину рынка (стакан ордеров), до 300 записей
`get_public_trades`	Получить последние публичные сделки на рынке
`get_k`	Получить данные K-линий (свечной график), поддерживаются различные таймфреймы

Таймфреймы K-линий (в минутах): 1 / 5 / 15 / 30 / 60 / 120 / 240 / 360 / 720 / 1440

Публичная информация M-кошелька (API-ключ не требуется)

Инструмент	Описание
`get_m_index_prices`	Получить индексные цены валют для M-кошелька
`get_m_limits`	Получить лимиты кредитования для M-кошелька
`get_m_interest_rates`	Получить процентные ставки по кредитам для валют M-кошелька

Управление счетом (требуется API-ключ)

Инструмент	Описание
`get_user_info`	Получить информацию об аккаунте (статус KYC, ID аккаунта и т.д.)
`get_accounts`	Получить баланс всех валют на счете (спот или M-кошелек)
`get_deposit_address`	Получить адрес для пополнения указанной валюты
`get_withdraw_addresses`	Получить список привязанных адресов для вывода средств

Управление ордерами (требуется API-ключ)

Инструмент	Описание
`submit_order`	Разместить ордер на покупку/продажу
`get_open_orders`	Получить список текущих открытых ордеров
`get_closed_orders`	Получить закрытые ордера (исполненные, отмененные и т.д.)
`get_orders_history`	Получить историю ордеров постранично по ID
`get_order`	Запросить детали конкретного ордера
`cancel_order`	Отменить один ордер
`cancel_orders`	Массовая отмена ордеров на рынке

Типы ордеров (ord_type): limit / market / stop_limit / stop_market / post_only / ioc_limit

История сделок (требуется API-ключ)

Инструмент	Описание
`get_trades`	Получить личную историю сделок
`get_order_trades`	Получить детали всех сделок по конкретному ордеру

Мгновенный обмен (требуется API-ключ)

Инструмент	Описание
`submit_convert`	Выполнить мгновенный обмен валют
`get_convert`	Запросить детали конкретного обмена
`get_converts`	Получить историю обменов

Депозиты и вывод средств (требуется API-ключ)

Инструмент	Описание
`submit_withdrawal`	Подать заявку на вывод криптовалюты
`submit_twd_withdrawal`	Подать заявку на вывод TWD
`get_withdrawal`	Запросить детали конкретного вывода
`get_withdrawals`	Получить историю выводов
`get_deposit`	Запросить детали конкретного депозита
`get_deposits`	Получить историю депозитов
`get_internal_transfers`	Получить историю внутренних переводов (между пользователями MAX)
`get_rewards`	Получить историю вознаграждений (реферальные, аирдропы, проценты и т.д.)

M-кошелек (требуется API-ключ)

Инструмент	Описание
`get_m_ad_ratio`	Получить коэффициент AD (активы/долг) M-кошелька, при падении ниже порога произойдет ликвидация
`submit_m_loan`	Подать заявку на кредит в M-кошельке
`get_m_loans`	Получить историю кредитов M-кошелька
`submit_m_transfer`	Перевод средств между спотовым кошельком и M-кошельком
`get_m_transfers`	Получить историю переводов M-кошелька
`submit_m_repayment`	Погашение кредита в M-кошельке
`get_m_repayments`	Получить историю погашений M-кошелька
`get_m_liquidations`	Получить историю ликвидаций M-кошелька
`get_m_liquidation`	Получить детали конкретной ликвидации M-кошелька
`get_m_interests`	Получить историю начисления процентов M-кошелька

Примеры использования

Задавайте вопросы на естественном языке прямо в Claude:

查詢 BTC/USDT 目前的價格

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

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

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

取消 btcusdt 所有未成交的買單

Примечания

Операции, такие как вывод средств и размещение ордеров, необратимы. Пожалуйста, проверяйте параметры перед выполнением.
Храните API-ключи в безопасности, не добавляйте их в систему контроля версий.
M-кошелек предполагает использование кредитного плеча, следите за коэффициентом AD, чтобы избежать риска ликвидации.

MAX Exchange MCP Server