Skip to main content
Glama

@qbtlabs/openmm-mcp

npm version npm downloads License: MIT Ask DeepWiki

📚 Dokumentation · 🤖 KI-Skills-Portal · 🔌 API-Referenz

MCP-Server für OpenMM — stellt Marktdaten, Kontoinformationen, Handels- und Strategietools für KI-Agenten über jeden beliebigen MCP-Client bereit.

Zwei Nutzungsmöglichkeiten

Option

Am besten geeignet für

API-Schlüssel

Zahlungen

Lokal (npm)

Volle Kontrolle, eigene Schlüssel

Verschlüsselter Tresor

Kostenlos

Gehostet (mcp.openmm.io)

Kein Setup, nutzungsbasierte Bezahlung

Nicht erforderlich für öffentliche Daten

x402 USDC


Related MCP server: polymarket-trader-mcp

Lokale Einrichtung

Voraussetzungen: Node.js 20 oder neuer.

1. Installieren und konfigurieren

npm install -g @qbtlabs/openmm-mcp
openmm-mcp --setup

Der Einrichtungsassistent schreibt die korrekte MCP-Konfiguration für Ihren Client (Claude Desktop, Claude Code, Cursor, Windsurf). Es werden keine Anmeldedaten in Konfigurationsdateien gespeichert — nur der Socket-Pfad.

2. Verschlüsselten Tresor initialisieren

openmm-init

Dies erstellt einen verschlüsselten Tresor unter ~/.openmm/vault.enc, der Ihren Wallet-Schlüssel und die API-Anmeldedaten für die Börsen enthält. Sie legen ein Passwort fest, generieren (oder importieren) eine Wallet und fügen optional Börsenschlüssel hinzu.

3. Server starten

openmm serve

Geben Sie Ihr Tresor-Passwort einmal ein. Der einheitliche Socket startet unter /tmp/openmm.sock — alle MCP-Clients verbinden sich hier. In keiner Konfigurationsdatei sind Anmeldedaten vorhanden.

Manuelle Konfiguration

Wenn Sie Konfigurationsdateien lieber direkt bearbeiten möchten, anstatt --setup zu verwenden:

Client

Konfigurationsdatei

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

Ersetzen Sie /path/to/openmm-mcp durch den tatsächlichen Installationspfad. Verwenden Sie für Claude Desktop den vollständigen Pfad zu node (z. B. aus which node), um nvm/PATH-Probleme zu vermeiden.

Tipp: Führen Sie stattdessen openmm-mcp --setup aus — dies schreibt automatisch die korrekten absoluten Pfade.

Keine API-Schlüssel. Keine privaten Schlüssel. Keine Passwörter. Nur der Socket-Pfad.

Ohne Tresor (Schnellstart)

Sie können den Tresor überspringen und API-Schlüssel direkt im env-Block übergeben:

{
  "mcpServers": {
    "openmm": {
      "command": "npx",
      "args": ["@qbtlabs/openmm-mcp"],
      "env": {
        "MEXC_API_KEY": "your_key",
        "MEXC_SECRET": "your_secret"
      }
    }
  }
}

Der Tresor stärkt jedes Szenario — nichts Sensibles befindet sich in einer Konfigurationsdatei, der Prozessumgebung oder dem Client-Speicher.

Client-Kompatibilität

Client

Ohne Tresor

Mit Tresor

Claude Desktop

API-Schlüssel in env

Nur OPENMM_SOCKET

Claude Code

API-Schlüssel in env

Nur OPENMM_SOCKET

Cursor

API-Schlüssel in env

Nur OPENMM_SOCKET

Windsurf

API-Schlüssel in env

Nur OPENMM_SOCKET

Alle Clients verbinden sich mit demselben laufenden openmm serve — ein Tresor, ein Socket, jeder Client.


Gehosteter Server mit x402-Zahlungen

Verbinden Sie sich mit mcp.openmm.io — für öffentliche Daten ist keine lokale Installation erforderlich. Bezahlen Sie pro Tool-Aufruf mit USDC auf Base.

Funktionsweise

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

Sicherheitseigenschaften

Eigenschaft

Wie

Schlüssel ruhend verschlüsselt

AES-256-GCM + PBKDF2 in ~/.openmm/vault.enc

Schlüssel niemals im Client-Speicher

MCP-Prozess hält nur den Socket-Pfad

Schlüssel niemals in Konfigurationsdateien

Keine API-Schlüssel, keine privaten Schlüssel in der Konfiguration

Prozessisolierung

Signierung erfolgt in openmm serve, nicht im KI-Agenten-Prozess

Richtliniendurchsetzung

Ausgabenlimits werden geprüft, bevor auf den privaten Schlüssel zugegriffen wird

Speichersicherheit

signAndWipe() — Schlüssel wird einmal verwendet und sofort aus dem Speicher gelöscht

Zahlungsablauf

  1. Agent ruft ein Tool auf

  2. Server gibt 402 Payment Required mit Preis zurück

  3. openmm serve signiert EIP-3009-Autorisierung (gasfrei — kein ETH erforderlich)

  4. Server reicht Zahlung on-chain ein und gibt Daten zurück

Tool-Preise

Kategorie

Tools

Preis (USDC)

Kostenlos

list_exchanges

$0.00

Lesen

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

$0.001

Schreiben

create_order, cancel_order, cancel_all_orders, start_grid_strategy, stop_strategy

$0.01


Verfügbare Tools (15)

Tool

Beschreibung

Parameter

Marktdaten

list_exchanges

Unterstützte Börsen auflisten

—

get_ticker

Echtzeitpreis, Bid/Ask, Spread, Volumen

exchange, symbol

get_orderbook

Orderbuch-Tiefe (Bids/Asks)

exchange, symbol, limit?

get_trades

Letzte Trades mit Kauf/Verkauf-Zusammenfassung

exchange, symbol, limit?

get_ohlcv

OHLCV-Kerzendaten

exchange, symbol, timeframe?, limit?

Konto

get_balance

Kontostände (alle oder gefiltert)

exchange, asset?

list_orders

Offene Orders (alle oder nach Symbol)

exchange, symbol?

Handel

create_order

Limit- oder Market-Order platzieren

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

cancel_order

Order nach ID stornieren

exchange, symbol, orderId

cancel_all_orders

Alle Orders für ein Paar stornieren

exchange, symbol

Cardano DEX

get_cardano_price

Aggregierter Token-Preis von DEXes

symbol

discover_pools

Liquiditätspools entdecken

symbol, minLiquidity?

Strategie

start_grid_strategy

Grid-Trading starten

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

stop_strategy

Laufende Strategie stoppen

strategyId, cancelOrders?

get_strategy_status

Strategiestatus abrufen

strategyId


CLI-Referenz

Setup & Server

Befehl

Beschreibung

openmm-init

Tresor erstellen, Wallet generieren/importieren, Börsen hinzufügen

openmm-init --import <key>

Tresor mit einem bestehenden privaten Schlüssel erstellen

openmm serve

Tresor entsperren, einheitlichen Socket starten

openmm-status

Tresor-, Socket-, Wallet- und Börsenstatus anzeigen (kein Passwort)

Börsen-Anmeldedaten

Befehl

Beschreibung

openmm-exchange list

Konfigurierte Börsen auflisten

openmm-exchange add <id>

Börsen-Anmeldedaten hinzufügen

openmm-exchange remove <id>

Börsen-Anmeldedaten entfernen

Unterstützte Börsen: mexc, gateio, bitget, kraken, binance, coinbase, okx

Wallet

Befehl

Beschreibung

openmm-wallet info

Wallet-Adresse und Chain anzeigen

openmm-wallet set

Wallet-Anmeldedaten festlegen

openmm-wallet export

Privaten Schlüssel anzeigen (erfordert Bestätigung)

Ausgabenrichtlinie

Befehl

Beschreibung

openmm-policy show

Aktuelle Richtlinie anzeigen

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

Max. USDC pro Transaktion

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

Max. USDC pro Tag

openmm-policy set allowed-chains <chains>

Kommagetrennte Chain-IDs

openmm-policy reset

Alle Richtlinienlimits löschen

Erweitert

Befehl

Beschreibung

openmm-vault info

Tresor-Metadaten anzeigen

openmm-vault change-password

Tresor-Passwort ändern

openmm-vault export

Alle Anmeldedaten exportieren (gefährlich)

openmm-vault destroy

Tresor löschen


Anwendungsbeispiel

BTC-Preis prüfen:

"Get me the BTC/USDT ticker on MEXC"

Order platzieren:

"Buy 0.1 ETH at $2400 on Kraken"

Grid-Strategie starten:

"Start a grid strategy on MEXC for INDY/USDT between $0.10 and $0.15 with 10 levels and $500 total"

Cardano-Token prüfen:

"What's the current price of SNEK on Cardano DEXes?"

Sicherheit

  • Tresor: AES-256-GCM verschlüsselt unter ~/.openmm/vault.enc

  • Passwort: Nur interaktives Terminal — niemals in einer Konfigurationsdatei, Umgebungsvariable oder CLI-Flag

  • Socket: /tmp/openmm.sock Modus 0600 — der Socket ist die Authentifizierungsgrenze

  • Richtlinie: Ausgabenlimits werden am Socket durchgesetzt, bevor der private Schlüssel berührt wird

  • Isolierung: Der private Schlüssel gelangt niemals in den Speicher eines MCP-Client-Prozesses — die Signierung erfolgt im openmm serve-Prozess via IPC


Entwicklung

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

Ressourcen

Lizenz

MIT

Gehostete Bereitstellung

Eine gehostete Bereitstellung ist auf Fronteir AI verfügbar.

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
      115 npm
      20
      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
      80 npm
      2
      MIT