Skip to main content
Glama

@qbtlabs/openmm-mcp

npm version npm downloads License: MIT Ask DeepWiki

📚 Документация · 🤖 Портал 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

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

~/.claude.json

Cursor

.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "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

Только OPENMM_SOCKET

Claude Code

API-ключи в env

Только OPENMM_SOCKET

Cursor

API-ключи в env

Только OPENMM_SOCKET

Windsurf

API-ключи в env

Только OPENMM_SOCKET

Все клиенты подключаются к одному запущенному 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 в ~/.openmm/vault.enc

Ключи никогда не попадают в память клиента

Процесс MCP хранит только путь к сокету

Ключи никогда не попадают в конфиг-файлы

Никаких API-ключей или приватных ключей в конфигах

Изоляция процессов

Подписание происходит в openmm serve, а не в процессе AI-агента

Принудительное соблюдение политик

Лимиты расходов проверяются до доступа к приватному ключу

Безопасность памяти

signAndWipe() — ключ используется один раз и немедленно удаляется из области видимости

Процесс оплаты

  1. Агент вызывает инструмент

  2. Сервер возвращает 402 Payment Required с ценой

  3. openmm serve подписывает авторизацию EIP-3009 (без газа — ETH не требуется)

  4. Сервер отправляет платеж в блокчейн и возвращает данные

Стоимость инструментов

Категория

Инструменты

Цена (USDC)

Бесплатно

list_exchanges

$0.00

Чтение

get_ticker, get_orderbook, get_trades, get_ohlcv, get_balance, list_orders, get_cardano_price, discover_pools, get_strategy_status

$0.001

Запись

create_order, cancel_order, cancel_all_orders, start_grid_strategy, stop_strategy

$0.01


Доступные инструменты (15)

Инструмент

Описание

Параметры

Рыночные данные

list_exchanges

Список поддерживаемых бирж

—

get_ticker

Цена в реальном времени, bid/ask, спред, объем

exchange, symbol

get_orderbook

Глубина книги ордеров (bids/asks)

exchange, symbol, limit?

get_trades

Последние сделки со сводкой покупки/продажи

exchange, symbol, limit?

get_ohlcv

Данные свечей OHLCV

exchange, symbol, timeframe?, limit?

Аккаунт

get_balance

Балансы аккаунта (все или отфильтрованные)

exchange, asset?

list_orders

Открытые ордера (все или по символу)

exchange, symbol?

Торговля

create_order

Размещение лимитного или рыночного ордера

exchange, symbol, type, side, amount, price?

cancel_order

Отмена ордера по ID

exchange, symbol, orderId

cancel_all_orders

Отмена всех ордеров для пары

exchange, symbol

Cardano DEX

get_cardano_price

Агрегированная цена токена с DEX

symbol

discover_pools

Поиск пулов ликвидности

symbol, minLiquidity?

Стратегия

start_grid_strategy

Запуск сеточной торговли

exchange, symbol, lowerPrice, upperPrice, gridLevels?, totalAmount

stop_strategy

Остановка запущенной стратегии

strategyId, cancelOrders?

get_strategy_status

Получение статуса стратегии

strategyId


Справочник CLI

Настройка и сервер

Команда

Описание

openmm-init

Создать хранилище, создать/импортировать кошелек, добавить биржи

openmm-init --import <key>

Создать хранилище с существующим приватным ключом

openmm serve

Разблокировать хранилище, запустить унифицированный сокет

openmm-status

Показать статус хранилища, сокета, кошелька и бирж (без пароля)

Учетные данные бирж

Команда

Описание

openmm-exchange list

Список настроенных бирж

openmm-exchange add <id>

Добавить учетные данные биржи

openmm-exchange remove <id>

Удалить учетные данные биржи

Поддерживаемые биржи: mexc, gateio, bitget, kraken, binance, coinbase, okx

Кошелек

Команда

Описание

openmm-wallet info

Показать адрес кошелька и сеть

openmm-wallet set

Установить учетные данные кошелька

openmm-wallet export

Отобразить приватный ключ (требуется подтверждение)

Политика расходов

Команда

Описание

openmm-policy show

Показать текущую политику

openmm-policy set max-per-tx <amount>

Макс. USDC за транзакцию

openmm-policy set max-per-day <amount>

Макс. USDC в день

openmm-policy set allowed-chains <chains>

ID сетей через запятую

openmm-policy reset

Сбросить все лимиты политики

Дополнительно

Команда

Описание

openmm-vault info

Показать метаданные хранилища

openmm-vault change-password

Изменить пароль хранилища

openmm-vault export

Экспортировать все учетные данные (опасно)

openmm-vault destroy

Удалить хранилище


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

Проверка цены 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

Ресурсы

Лицензия

MIT

Хостинг-развертывание

Хостинг-развертывание доступно на Fronteir AI.

Available Tools

13 tools
cancel_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

    B3.4/5.0

    Scored across 13 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides cryptocurrency trading signals, market analysis, and portfolio management capabilities across 15+ exchanges with AI-enhanced technical analysis, arbitrage detection, and risk assessment tools.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Trade, analyze, and automate Polymarket prediction markets via AI. 34 tools for direct trading, smart money flow, copy trading, backtest, and portfolio management.
      48
      197 npm
      19
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      7
      88 npm
      2
      MIT