OKX Agent Trade Kit MCP
Официальный набор OKX для агентов: MCP-сервер на 167 инструментов, CLI и скиллы для рыночных данных, ордеров, ботов и накоплений на бирже OKX
- 492 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Ключ с правом Trade позволяет агенту выставлять, менять и отменять ордера и запускать торговых ботов с реальными деньгами
- Инструменты открывают баланс, позиции и историю операций вашего счета
- Ключи API лежат в файле ~/.okx/config.toml на вашем компьютере, и доступ к нему равен доступу к счету
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/okx-agent-trade-kitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключ с правом Trade позволяет агенту выставлять, менять и отменять ордера и запускать торговых ботов с реальными деньгами
- Инструменты открывают баланс, позиции и историю операций вашего счета
- Ключи API лежат в файле ~/.okx/config.toml на вашем компьютере, и доступ к нему равен доступу к счету
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Набор состоит из двух пакетов: okx-trade-mcp, MCP-сервер для Claude, Cursor и других клиентов, и okx-trade-cli, консольная утилита okx. Оба запускаются локально, ключи API хранятся в файле ~/.okx/config.toml на вашем компьютере и никуда не отправляются, кроме самой биржи. Вместо переключения между ассистентом и интерфейсом биржи вы описываете задачу словами, а агент вызывает нужные инструменты. Инструменты разбиты на 11 модулей. Рынок дает котировки, стакан, свечи, ставки финансирования, открытый интерес и более 70 технических индикаторов. Спот, бессрочные свопы, поставочные фьючерсы и опционы позволяют ставить, менять и отменять ордера, включая условные, OCO и трейлинг-стоп. Отдельные модули охватывают баланс и счет, торговых ботов (сеточные и DCA), накопления (Simple Earn, ончейн-стейкинг, двойные депозиты), событийные контракты, новости и аналитику умных денег. По умолчанию сервер включает модули спота, свопов и счета. Флаг --modules выбирает другой набор, а --read-only оставляет только запросы без записи. В каталоге skills/ лежат шесть готовых скиллов, которые объясняют агенту, когда и как вызывать CLI.
Для кого. Для трейдеров и разработчиков торговых скриптов с аккаунтом OKX, которые хотят управлять рыночными данными, ордерами и ботами из Claude Code, Cursor или Claude Desktop.
Подходит, если
- Нужно запросить котировки BTC-USDT, свечи и RSI с MACD без ключа: модуль `market` работает без авторизации
- Хочется отладить сценарий на демо-профиле с учебным ключом, а позже подключить отдельный профиль `live`
- Требуется выставить условный ордер с тейк-профитом и стоп-лоссом через OCO или трейлинг-стоп
- Надо проверить баланс, позиции и историю счета из терминала командами вроде `okx account balance`
- Агентной системе нужны готовые скиллы для рынка, торговли, портфеля, ботов и накоплений с описанием, когда их включать
Не подходит, если
- Нужен другой брокер или биржа: набор работает только с OKX, для многих бирж есть отдельные серверы
- Нужен индивидуальный совет, что покупать: инструмент выполняет команды, но сам ничего не рекомендует и инвестиционным советником не служит
- Нельзя доверять ассистенту реальные деньги без контроля: ордера и боты на боевом профиле исполняются по-настоящему
- Нужны выводы средств: права на вывод ключу не требуются и не рекомендуются
- Аккаунт зарегистрирован на региональном сайте OKX, к которому у вас нет доступа: API работает по сайту регистрации
Пример запроса к агенту
Покажи цену и свечи BTC-USDT за последние сутки, посчитай RSI и скажи, какие у меня сейчас позиции на демо-профиле, ордера пока не выставляйMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
OKX_SITE- Региональный сайт OKX: global, eea, us или tr; по умолчанию global
Ограничения
Для работы нужны Node.js 18 и новее, а для приватных модулей ключ API OKX с правами Read и Trade, секретный ключ и парольная фраза. Право на вывод не требуется. Рыночные данные доступны без авторизации.
OKX работает независимыми региональными сайтами: global, eea, us и tr. Нужно использовать API того сайта, где зарегистрирован аккаунт, и задать его флагом --site или переменной OKX_SITE. Поддерживаются только HTTP- и HTTPS-прокси, SOCKS не поддерживается. Ключи демо- и боевой торговли создаются отдельно.
Автор заранее отключил лишние модули: без флага --modules включены `spot`, `swap` и `account`, а накопления подключаются через `--modules all`. Доступность OKX из России автор не описывает, и проверять ее нужно самостоятельно. Это не инвестиционная рекомендация.
Как отключить. Удалите запись okx из конфигурации MCP вашего клиента или команду из настроек Claude Code. Пакеты снимаются командой `npm uninstall -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli`. Ключи лежат в ~/.okx/config.toml: удалите файл и отзовите ключ в настройках API на сайте OKX.
Частые вопросы
Как подключить OKX к Claude Code через MCP?
Установите пакеты командой npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli, настройте ключи через okx config init и выполните okx-trade-mcp setup --client claude-code. Для Claude Desktop, Cursor и VS Code подставьте claude-desktop, cursor или vscode.
Можно ли сначала попробовать без реальных денег?
Да, профиль `demo` в ~/.okx/config.toml использует ключ демо-торговли OKX, а отдельный профиль `live` подключается как второй MCP-сервер. Агент переключается между ними вызовом инструментов нужного сервера.
Как запретить агенту ставить ордера?
Запустите сервер с флагом --read-only: останутся только инструменты запросов. Дополнительно ограничьте набор модулей через --modules, например `market` или `spot,account`.
Какие права нужны ключу API?
Read и Trade. Право на вывод средств не требуется и не рекомендуется. Рыночные данные из модуля `market` работают без ключа.
Чем MCP-сервер отличается от скиллов в этом наборе?
Сервер дает агенту 167 инструментов в формате MCP. Скиллы в каталоге skills/ учат агента работать с CLI okx: каждый сообщает, когда включаться и какие команды вызывать, и покрывает рынок, торговлю, портфель, ботов, накопления и аналитику умных денег.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер и скиллы CCXT: рыночные данные, балансы и торговля по выбору на криптобиржах и рынках предсказаний
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers
MCP-сервер с рыночными данными и техническим анализом: котировки, индикаторы, скринеры и бэктест для акций, крипты, форекса и фьючерсов
MCP-сервер для агентного трейдинга: бэктест, 462 готовые альфы, разбор торгового журнала и мультиагентные аналитические команды
Неофициальный клиент Yahoo Finance с MCP-сервером, CLI и агентским скиллом: котировки, история цен, финансовые отчеты и опционы для агента
MCP-сервер котировок и стаканов Мосбиржи через ISS+ и ISS REST плюс Telegram-бот, который сам выбирает нужный инструмент через OpenAI tool calling
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OKX Agent Trade Kit (эта запись) | да | API-ключ | 492 | |
| CCXT MCP Server | да | ключ необязателен | 44 612 | универсальный MCP-сервер для многих криптобирж; этот набор охватывает только OKX, зато шире по модулям |
| MetaTrader MCP Server | нет | не нужна | 843 | MCP-сервер для терминала MetaTrader 5 |
Коротко о README
Документ представляет два пакета, okx-trade-mcp и okx-trade-cli, и объясняет, что набор работает локально без серверов и баз данных. Таблицы перечисляют особенности и 11 модулей с числом инструментов. Быстрый старт состоит из установки, мастера ключей и команды setup для клиента, а ниже показаны режимы запуска сервера и примеры команд CLI. Отдельно описаны шесть скиллов с отметкой, нужна ли авторизация, правила сообщения об ошибках с форматами для MCP и CLI, сборка из исходников и список документации.