openmm-mcp
@qbtlabs/openmm-mcp
📚 Документация · 🤖 Портал AI-навыков · 🔌 Справочник API
MCP-сервер для OpenMM — предоставляет AI-агентам доступ к рыночным данным, аккаунтам, торговым инструментам и стратегиям через любой MCP-клиент.
Два способа использования
Вариант | Лучше всего подходит для | API-ключи | Платежи |
Локально (npm) | Полный контроль, ваши собственные ключи | Зашифрованное хранилище | Бесплатно |
Хостинг (mcp.openmm.io) | Без настройки, оплата за использование | Не нужны для публичных данных | x402 USDC |
Related MCP server: polymarket-trader-mcp
Локальная установка
Предварительные требования: Node.js 20 или новее.
1. Установка и настройка
npm install -g @qbtlabs/openmm-mcp
openmm-mcp --setupМастер настройки создает правильную конфигурацию MCP для вашего клиента (Claude Desktop, Claude Code, Cursor, Windsurf). Учетные данные не сохраняются в конфигурационных файлах — только путь к сокету.
2. Инициализация зашифрованного хранилища
openmm-initЭто создает зашифрованное хранилище по адресу ~/.openmm/vault.enc, содержащее ключ вашего кошелька и учетные данные API бирж. Вы установите пароль, создадите (или импортируете) кошелек и при желании добавите ключи бирж.
3. Запуск сервера
openmm serveВведите пароль от хранилища один раз. Унифицированный сокет запускается по адресу /tmp/openmm.sock — все MCP-клиенты подключаются к нему. Никакие учетные данные не хранятся в конфигурационных файлах.
Ручная настройка
Если вы предпочитаете редактировать конфигурационные файлы напрямую, а не использовать --setup:
Клиент | Конфигурационный файл |
Claude Desktop |
|
Claude Code |
|
Cursor |
|
Windsurf |
|
{
"mcpServers": {
"openmm": {
"command": "node",
"args": ["/path/to/openmm-mcp/dist/index.js"],
"env": {
"MCP_TRANSPORT": "stdio",
"OPENMM_SOCKET": "/tmp/openmm.sock",
"PAYMENT_SERVER": "https://mcp.openmm.io",
"X402_TESTNET": "true"
}
}
}
}Замените /path/to/openmm-mcp на фактический путь установки. Для Claude Desktop используйте полный путь к node (например, из which node), чтобы избежать проблем с nvm/PATH.
Совет: Вместо этого запустите
openmm-mcp --setup— он автоматически запишет правильные абсолютные пути.
Никаких API-ключей. Никаких приватных ключей. Никаких паролей. Только путь к сокету.
Без хранилища (быстрый старт)
Вы можете пропустить создание хранилища и передать API-ключи напрямую в блоке env:
{
"mcpServers": {
"openmm": {
"command": "npx",
"args": ["@qbtlabs/openmm-mcp"],
"env": {
"MEXC_API_KEY": "your_key",
"MEXC_SECRET": "your_secret"
}
}
}
}Хранилище усиливает безопасность в любом сценарии — конфиденциальные данные не попадают в конфигурационные файлы, переменные окружения процесса или память клиента.
Совместимость с клиентами
Клиент | Без хранилища | С хранилищем |
Claude Desktop | API-ключи в env | Только |
Claude Code | API-ключи в env | Только |
Cursor | API-ключи в env | Только |
Windsurf | API-ключи в env | Только |
Все клиенты подключаются к одному запущенному openmm serve — одно хранилище, один сокет, любой клиент.
Хостинг-сервер с платежами x402
Подключайтесь к mcp.openmm.io — для публичных данных локальная установка не требуется.
Оплачивайте каждый вызов инструмента с помощью USDC в сети Base.
Как это работает
AI Agent (Claude / Cursor / Windsurf)
│ MCP stdio — no keys in config
▼
MCP Client Process
(reads OPENMM_SOCKET — credentials never here)
│ Unix socket /tmp/openmm.sock (mode 0600)
▼
openmm serve — unified vault process
┌──────────────────────────────────┐
│ ~/.openmm/vault.enc │
│ AES-256-GCM + PBKDF2 │ ← wallet key + exchange keys, one vault
│ │ │
│ Policy Engine │ ← maxPerTx, maxPerDay, allowedChains
│ (checked before key is touched) │
│ │ │
│ signAndWipe() │ ← key used inline, wiped from memory
└──────────────────────────────────┘
│ EIP-3009 signature only
▼
mcp.openmm.io → x402 verification → Base L2 settlementСвойства безопасности
Свойство | Как реализовано |
Ключи зашифрованы в покое | AES-256-GCM + PBKDF2 в |
Ключи никогда не попадают в память клиента | Процесс MCP хранит только путь к сокету |
Ключи никогда не попадают в конфиг-файлы | Никаких API-ключей или приватных ключей в конфигах |
Изоляция процессов | Подписание происходит в |
Принудительное соблюдение политик | Лимиты расходов проверяются до доступа к приватному ключу |
Безопасность памяти |
|
Процесс оплаты
Агент вызывает инструмент
Сервер возвращает
402 Payment Requiredс ценойopenmm serveподписывает авторизацию EIP-3009 (без газа — ETH не требуется)Сервер отправляет платеж в блокчейн и возвращает данные
Стоимость инструментов
Категория | Инструменты | Цена (USDC) |
Бесплатно |
| $0.00 |
Чтение |
| $0.001 |
Запись |
| $0.01 |
Доступные инструменты (15)
Инструмент | Описание | Параметры |
Рыночные данные | ||
| Список поддерживаемых бирж | — |
| Цена в реальном времени, bid/ask, спред, объем |
|
| Глубина книги ордеров (bids/asks) |
|
| Последние сделки со сводкой покупки/продажи |
|
| Данные свечей OHLCV |
|
Аккаунт | ||
| Балансы аккаунта (все или отфильтрованные) |
|
| Открытые ордера (все или по символу) |
|
Торговля | ||
| Размещение лимитного или рыночного ордера |
|
| Отмена ордера по ID |
|
| Отмена всех ордеров для пары |
|
Cardano DEX | ||
| Агрегированная цена токена с DEX |
|
| Поиск пулов ликвидности |
|
Стратегия | ||
| Запуск сеточной торговли |
|
| Остановка запущенной стратегии |
|
| Получение статуса стратегии |
|
Справочник CLI
Настройка и сервер
Команда | Описание |
| Создать хранилище, создать/импортировать кошелек, добавить биржи |
| Создать хранилище с существующим приватным ключом |
| Разблокировать хранилище, запустить унифицированный сокет |
| Показать статус хранилища, сокета, кошелька и бирж (без пароля) |
Учетные данные бирж
Команда | Описание |
| Список настроенных бирж |
| Добавить учетные данные биржи |
| Удалить учетные данные биржи |
Поддерживаемые биржи: mexc, gateio, bitget, kraken, binance, coinbase, okx
Кошелек
Команда | Описание |
| Показать адрес кошелька и сеть |
| Установить учетные данные кошелька |
| Отобразить приватный ключ (требуется подтверждение) |
Политика расходов
Команда | Описание |
| Показать текущую политику |
| Макс. USDC за транзакцию |
| Макс. USDC в день |
| ID сетей через запятую |
| Сбросить все лимиты политики |
Дополнительно
Команда | Описание |
| Показать метаданные хранилища |
| Изменить пароль хранилища |
| Экспортировать все учетные данные (опасно) |
| Удалить хранилище |
Пример использования
Проверка цены BTC:
"Get me the BTC/USDT ticker on MEXC"Размещение ордера:
"Buy 0.1 ETH at $2400 on Kraken"Запуск сеточной стратегии:
"Start a grid strategy on MEXC for INDY/USDT between $0.10 and $0.15 with 10 levels and $500 total"Проверка токена Cardano:
"What's the current price of SNEK on Cardano DEXes?"Безопасность
Хранилище: AES-256-GCM зашифровано в
~/.openmm/vault.encПароль: Только интерактивный терминал — никогда не попадает в конфиг-файлы, переменные окружения или флаги CLI
Сокет:
/tmp/openmm.sockрежим0600— сокет является границей аутентификацииПолитика: Лимиты расходов применяются на уровне сокета до обращения к приватному ключу
Изоляция: Приватный ключ никогда не попадает в память процесса MCP-клиента — подписание происходит в процессе
openmm serveчерез IPC
Разработка
git clone https://github.com/QBT-Labs/openMM-MCP.git
cd openMM-MCP
npm install
npm run typecheck
npm run lint
npm test
npm run buildРесурсы
OpenMM SDK — Базовый торговый SDK
Пакет x402 — Интеграция платежей
Спецификация MCP — Документация Model Context Protocol
Сеть Base — L2 для платежей в USDC
Лицензия
MIT
Хостинг-развертывание
Хостинг-развертывание доступно на Fronteir AI.
Available Tools
13 toolscancel_all_ordersAInspect
Cancel all open orders for a trading pair on a supported exchange
Inputs: exchange (required), symbol (required).
cancel_orderAInspect
Cancel a specific order by ID on a supported exchange
Inputs: exchange (required), symbol (required), orderId (required).
create_orderBInspect
Create a new order (limit or market) on a supported exchange
Inputs: exchange (required), symbol (required), type (required), side (required), +2 more.
discover_poolsAInspect
Discover Cardano DEX liquidity pools for a native token via Iris API
Inputs: symbol (required).
get_balanceAInspect
Get account balances for all assets (or a specific asset) on a supported exchange
Inputs: exchange (required), asset.
get_cardano_priceAInspect
Get aggregated price for a Cardano native token from DEX liquidity pools (TOKEN/USDT via ADA bridge)
Inputs: symbol (required).
get_orderbookBInspect
Fetch order book depth (bids and asks) for a trading pair on a supported exchange
Inputs: exchange (required), symbol (required), limit.
get_strategy_statusAInspect
Get current grid strategy status: open orders, current price, and P&L estimate
Inputs: exchange (required), symbol (required).
get_tickerAInspect
Get real-time price, bid/ask, spread, and volume for a trading pair on a supported exchange
Inputs: exchange (required), symbol (required).
get_tradesCInspect
Get recent trades for a trading pair on a supported exchange
Inputs: exchange (required), symbol (required), limit.
list_ordersAInspect
List open orders on a supported exchange, optionally filtered by trading pair symbol
Inputs: exchange (required), symbol.
start_grid_strategyBInspect
Calculate and optionally place grid trading orders around the current price
Inputs: exchange (required), symbol (required), levels, spacing, +5 more.
stop_strategyAInspect
Cancel all open orders for a trading pair, effectively stopping any running grid strategy
Inputs: exchange (required), symbol (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools have distinct purposes, such as create_order for order creation and get_ticker for price data. However, cancel_all_orders and stop_strategy both involve canceling orders for a trading pair, which could cause confusion in selection, though stop_strategy is tied to grid strategies.
The naming follows a consistent verb_noun pattern with snake_case throughout, such as get_balance and list_orders. Minor deviations exist, like discover_pools using 'discover' instead of 'get' or 'list', but overall the pattern is clear and readable.
With 13 tools, the count is well-scoped for a trading and strategy automation server. Each tool serves a specific function, from order management to price fetching and strategy control, without feeling excessive or insufficient for the domain.
The toolset covers core trading operations like order CRUD, balance checks, and market data, plus grid strategy management. A minor gap is the lack of tools for modifying existing orders (e.g., update_order) or detailed strategy configuration, but agents can work around this with the available tools.
Maintenance
Related MCP Connectors
AI prediction market trading — real-time data, CLOB exchange, Prop Desk, 40+ tools
Non-custodial DeFi tools for AI agents on Solana: swaps, perps, lending, staking, equities.
AI crypto signals, whale positions, 19 technical indicators, derivatives, screener and backtests
Crypto market signals and portfolio telemetry. 6 tools pay-per-call in USDC, no API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides cryptocurrency trading signals, market analysis, and portfolio management capabilities across 15+ exchanges with AI-enhanced technical analysis, arbitrage detection, and risk assessment tools.2MIT
- AlicenseAqualityDmaintenanceTrade, analyze, and automate Polymarket prediction markets via AI. 34 tools for direct trading, smart money flow, copy trading, backtest, and portfolio management.48197 npm19MIT

Haiku DeFi MCPofficial
AlicenseAqualityDmaintenanceMCP server for DeFi execution — lets AI agents swap, provide liquidity, lend, bridge, and run yield strategies across 22 chains in a single transaction. 7 tools for token discovery, portfolio analysis, quoting, and execution via the Haiku API.788 npm2MIT- AlicenseNot gradedqualityDmaintenanceEnables AI-powered cryptocurrency trading and analytics across multiple exchanges and blockchains, with integrated Telegram bot and live trading capabilities.3MIT