Openmm Mcp

io.github.QBT-Labs由 GitHub 帳號 QBT-Labs 發布v1.0.14更新於 Oct 24, 2026

MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents

已驗證Streamable HTTP可網頁執行金融商業與電商

概覽

AI 產生的概覽

OpenMM MCP 讓 AI 助理取得加密貨幣行情、查詢交易所帳戶、下單交易，並使用網格策略工具，涵蓋多家交易所與 Cardano DEX。

可以做什麼
  • 列出支援的交易所及其所需憑證
  • 讀取行情：最新報價、委託簿、近期成交與 K 線資料
  • 查詢帳戶餘額並列出未成交委託
  • 送出限價單或市價單，取消單筆委託或某交易對的全部委託
  • 查詢 Cardano DEX 代幣價格並探索流動性池
  • 啟動、停止並檢視網格策略狀態與損益估算
適用情境
適合讓助理以自然語言盯盤、查看交易所餘額與掛單，或直接下單與管理網格策略。也適合快速查詢 Cardano 原生代幣在 DEX 流動性池中的價格。
執行需求
可使用 mcp.openmm.io 託管端點，或在本地安裝，本地需 Node.js 20 以上版本。本地使用需執行初始化與保險庫指令、在終端機輸入保險庫密碼，並提供交易所 API 金鑰（例如 MEXC_API_KEY 與 MEXC_SECRET），可存入加密保險庫或寫在 env 設定中。託管端點的公開資料無需金鑰，但每次呼叫以 Base 上的 USDC 付費。
安裝前請注意
此伺服器可動用真實資金：create_order、cancel_order、cancel_all_orders 及網格策略工具會送出與取消真實交易，託管方式另按次收取 USDC。保險庫保存錢包私鑰與交易所 API 憑證，openmm-wallet export 與 openmm-vault export 可將其匯出。寫在 env 中的交易所金鑰會以明文留在用戶端設定檔中。使用前請確認消費策略上限。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Openmm Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.QBT-Labs%2Fopenmm-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "openmm": {
      "type": "http",
      "url": "https://mcp.openmm.io/mcp"
    }
  }
}

README

@qbtlabs/openmm-mcp

[smithery badge] [npm version] [npm downloads] [License: MIT] [Ask DeepWiki]

📚 Documentation · 🤖 AI Skills Portal · 🔌 API Reference

MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents via any MCP client.

[openmm-mcp MCP server]

Two Ways to Use

OptionBest ForAPI KeysPayments
Local (npm)Full control, your own keysEncrypted vaultFree
Hosted (mcp.openmm.io)No setup, pay-per-useNot needed for public datax402 USDC

Local Setup

Prerequisites: Node.js 20 or later.

1. Install and configure

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

The setup wizard writes the correct MCP config for your client (Claude Desktop, Claude Code, Cursor, Windsurf). No credentials are stored in config files — only the socket path.

2. Initialize encrypted vault

bash
openmm-init

This creates an encrypted vault at ~/.openmm/vault.enc containing your wallet key and exchange API credentials. You'll set a password, generate (or import) a wallet, and optionally add exchange keys.

3. Start the server

bash
openmm serve

Type your vault password once. The unified socket starts at /tmp/openmm.sock — all MCP clients connect here. No credentials exist in any config file.

Manual configuration

If you prefer to edit config files directly instead of using --setup:

ClientConfig file
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Claude Code~/.claude.json
Cursor.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
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"      }    }  }}

Replace /path/to/openmm-mcp with the actual install path. For Claude Desktop, use the full path to node (e.g. from which node) to avoid nvm/PATH issues.

Tip: Run openmm-mcp --setup instead — it writes the correct absolute paths automatically.

No API keys. No private keys. No passwords. Just the socket path.

Without vault (quick start)

You can skip the vault and pass API keys directly in the env block:

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

The vault strengthens every scenario — nothing sensitive exists in any config file, process environment, or client memory.

Client compatibility

ClientWithout vaultWith vault
Claude DesktopAPI keys in envOnly OPENMM_SOCKET
Claude CodeAPI keys in envOnly OPENMM_SOCKET
CursorAPI keys in envOnly OPENMM_SOCKET
WindsurfAPI keys in envOnly OPENMM_SOCKET

All clients connect to the same running openmm serve — one vault, one socket, any client.

Hosted Server with x402 Payments

Connect to mcp.openmm.io — no local installation needed for public data. Pay per tool call with USDC on Base.

How it works

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

Security properties

PropertyHow
Keys encrypted at restAES-256-GCM + PBKDF2 in ~/.openmm/vault.enc
Keys never in client memoryMCP process only holds socket path
Keys never in config filesNo API keys, no private keys anywhere in config
Process isolationSigning happens in openmm serve, not in the AI agent process
Policy enforcementSpending limits checked before private key is accessed
Memory safetysignAndWipe() — key used once, goes out of scope immediately

Payment flow

  1. Agent calls a tool
  2. Server returns 402 Payment Required with price
  3. openmm serve signs EIP-3009 authorization (gasless — no ETH needed)
  4. Server submits payment on-chain and returns data

Tool Pricing

CategoryToolsPrice (USDC)
Freelist_exchanges$0.00
Readget_ticker, get_orderbook, get_trades, get_ohlcv, get_balance, list_orders, get_cardano_price, discover_pools, get_strategy_status$0.001
Writecreate_order, cancel_order, cancel_all_orders, start_grid_strategy, stop_strategy$0.01

Available Tools (15)

ToolDescriptionParameters
Market Data
list_exchangesList supported exchanges—
get_tickerReal-time price, bid/ask, spread, volumeexchange, symbol
get_orderbookOrder book depth (bids/asks)exchange, symbol, limit?
get_tradesRecent trades with buy/sell summaryexchange, symbol, limit?
get_ohlcvOHLCV candlestick dataexchange, symbol, timeframe?, limit?
Account
get_balanceAccount balances (all or filtered)exchange, asset?
list_ordersOpen orders (all or by symbol)exchange, symbol?
Trading
create_orderPlace limit or market orderexchange, symbol, type, side, amount, price?
cancel_orderCancel order by IDexchange, symbol, orderId
cancel_all_ordersCancel all orders for a pairexchange, symbol
Cardano DEX
get_cardano_priceAggregated token price from DEXessymbol
discover_poolsDiscover direct ADA pools via Minswap and SundaeSwapsymbol
Strategy
start_grid_strategyStart grid tradingexchange, symbol, lowerPrice, upperPrice, gridLevels?, totalAmount
stop_strategyStop a running strategystrategyId, cancelOrders?
get_strategy_statusGet strategy statusstrategyId

CLI Reference

Setup & Server

CommandDescription
openmm-initCreate vault, generate/import wallet, add exchanges
openmm-init --import <key>Create vault with an existing private key
openmm serveUnlock vault, start unified socket
openmm-statusShow vault, socket, wallet, and exchange status (no password)

Exchange Credentials

CommandDescription
openmm-exchange listList configured exchanges
openmm-exchange add <id>Add exchange credentials
openmm-exchange remove <id>Remove exchange credentials

Supported exchanges: mexc, gateio, bitget, kraken, binance, coinbase, okx

Wallet

CommandDescription
openmm-wallet infoShow wallet address and chain
openmm-wallet setSet wallet credentials
openmm-wallet exportDisplay private key (requires confirmation)

Spending Policy

CommandDescription
openmm-policy showShow current policy
openmm-policy set max-per-tx <amount>Max USDC per transaction
openmm-policy set max-per-day <amount>Max USDC per day
openmm-policy set allowed-chains <chains>Comma-separated chain IDs
openmm-policy resetClear all policy limits

Advanced

CommandDescription
openmm-vault infoShow vault metadata
openmm-vault change-passwordChange vault password
openmm-vault exportExport all credentials (dangerous)
openmm-vault destroyDelete the vault

Example Usage

Check BTC price:

"Get me the BTC/USDT ticker on MEXC"

Place an order:

"Buy 0.1 ETH at $2400 on Kraken"

Start grid strategy:

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

Check Cardano token:

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

Security

  • Vault: AES-256-GCM encrypted at ~/.openmm/vault.enc
  • Password: Interactive terminal only — never in any config file, env var, or CLI flag
  • Socket: /tmp/openmm.sock mode 0600 — the socket is the authentication boundary
  • Policy: Spending limits enforced at the socket before the private key is touched
  • Isolation: Private key never enters any MCP client process memory — signing happens in the openmm serve process via IPC

Development

bash
git clone https://github.com/QBT-Labs/openMM-MCP.gitcd openMM-MCPnpm installnpm run typechecknpm run lintnpm testnpm run build

Resources

License

MIT

Hosted deployment

A hosted deployment is available on Fronteir AI.

來源：README.md，提交 7f10368

工具

15

list_exchanges

List all supported exchanges with their IDs, features, and required credentials

無需輸入參數。

get_ticker

Get real-time price, bid/ask, spread, and volume for a trading pair

輸入參數symbol必填exchange必填

get_orderbook

Fetch order book depth (bids and asks) for a trading pair

輸入參數limitsymbol必填exchange必填

get_trades

Get recent trades for a trading pair

輸入參數limitsymbol必填exchange必填

get_ohlcv

Get OHLCV (candlestick) data for a trading pair

輸入參數limitsymbol必填exchange必填timeframe

get_balance

Get account balances for all assets (or a specific asset) on a supported exchange

輸入參數assetexchange必填

list_orders

List open orders on a supported exchange, optionally filtered by trading pair symbol

輸入參數symbolexchange必填

create_order

Create a new order (limit or market) on a supported exchange

輸入參數side必填type必填priceamount必填symbol必填exchange必填

cancel_order

Cancel a specific order by ID on a supported exchange

輸入參數symbol必填orderId必填exchange必填

cancel_all_orders

Cancel all open orders for a trading pair on a supported exchange

輸入參數symbol必填exchange必填

get_cardano_price

Get aggregated price for a Cardano native token from DEX liquidity pools (TOKEN/USDT via ADA bridge)

輸入參數symbol必填

discover_pools

Discover Cardano DEX liquidity pools for a native token via Iris API

輸入參數symbol必填

start_grid_strategy

Calculate and optionally place grid trading orders around the current price

輸入參數dryRunlevelssymbol必填spacingexchange必填orderSizesizeModelspacingModelspacingFactor

stop_strategy

Cancel all open orders for a trading pair, effectively stopping any running grid strategy

輸入參數symbol必填exchange必填

get_strategy_status

Get current grid strategy status: open orders, current price, and P&L estimate

輸入參數symbol必填exchange必填

版本歷史

1
  1. v1.0.14最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分