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 分