openmm-mcp
@qbtlabs/openmm-mcp
📚 ドキュメント · 🤖 AIスキルポータル · 🔌 APIリファレンス
OpenMM 用のMCPサーバー。マーケットデータ、アカウント、取引、戦略ツールを、あらゆるMCPクライアントを通じてAIエージェントに提供します。
2つの利用方法
オプション | 最適な用途 | 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セットアップウィザードが、お使いのクライアント(Claude Desktop、Claude Code、Cursor、Windsurf)に適したMCP設定を書き込みます。設定ファイルには認証情報は保存されず、ソケットパスのみが保存されます。
2. 暗号化ボルトの初期化
openmm-initこれにより、ウォレットキーと取引所のAPI認証情報を含む暗号化されたボルトが ~/.openmm/vault.enc に作成されます。パスワードを設定し、ウォレットを生成(またはインポート)し、必要に応じて取引所のキーを追加します。
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の場合は、nvm/PATHの問題を避けるため、node へのフルパス(which node で確認可能)を使用してください。
ヒント:
openmm-mcp --setupを実行してください。正しい絶対パスが自動的に書き込まれます。
APIキーも、秘密鍵も、パスワードも不要です。必要なのはソケットパスだけです。
ボルトなし(クイックスタート)
ボルトをスキップして、env ブロックで直接APIキーを渡すことも可能です:
{
"mcpServers": {
"openmm": {
"command": "npx",
"args": ["@qbtlabs/openmm-mcp"],
"env": {
"MEXC_API_KEY": "your_key",
"MEXC_SECRET": "your_secret"
}
}
}
}ボルトを使用することで、設定ファイル、プロセス環境、クライアントメモリのいずれにも機密情報が存在しない状態となり、セキュリティが強化されます。
クライアントの互換性
クライアント | ボルトなし | ボルトあり |
Claude Desktop | envにAPIキー |
|
Claude Code | envにAPIキー |
|
Cursor | envにAPIキー |
|
Windsurf | envにAPIキー |
|
すべてのクライアントが実行中の openmm serve に接続します。1つのボルト、1つのソケットで、どのクライアントからでも利用可能です。
x402支払い対応のホスト型サーバー
mcp.openmm.io に接続してください。公開データであればローカルインストールは不要です。
Baseチェーン上のUSDCを使用して、ツール呼び出しごとに支払います。
仕組み
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セキュリティ特性
特性 | 方法 |
キーの保存時暗号化 |
|
クライアントメモリにキーを保持しない | MCPプロセスはソケットパスのみを保持 |
設定ファイルにキーを保持しない | 設定ファイルにはAPIキーや秘密鍵は一切なし |
プロセスの分離 | 署名はAIエージェントプロセスではなく |
ポリシーの強制 | 秘密鍵へのアクセス前に支出制限をチェック |
メモリ安全性 |
|
支払いフロー
エージェントがツールを呼び出す
サーバーが価格とともに
402 Payment Requiredを返すopenmm serveがEIP-3009認証に署名する(ガス代不要 — ETH不要)サーバーがオンチェーンで支払いを送信し、データを返す
ツール価格
カテゴリ | ツール | 価格 (USDC) |
無料 |
| $0.00 |
読み取り |
| $0.001 |
書き込み |
| $0.01 |
利用可能なツール (15)
ツール | 説明 | パラメータ |
マーケットデータ | ||
| 対応取引所の一覧 | — |
| リアルタイム価格、買値/売値、スプレッド、出来高 |
|
| オーダーブックの深さ(買値/売値) |
|
| 最近の取引と売買サマリー |
|
| OHLCVローソク足データ |
|
アカウント | ||
| アカウント残高(全資産または指定資産) |
|
| 未決済注文(全注文またはシンボル指定) |
|
取引 | ||
| 指値または成行注文の発注 |
|
| IDによる注文キャンセル |
|
| ペアの全注文をキャンセル |
|
Cardano DEX | ||
| DEXからの集計トークン価格 |
|
| 流動性プールの検索 |
|
戦略 | ||
| グリッド取引の開始 |
|
| 実行中の戦略を停止 |
|
| 戦略ステータスの取得 |
|
CLIリファレンス
セットアップとサーバー
コマンド | 説明 |
| ボルト作成、ウォレット生成/インポート、取引所追加 |
| 既存の秘密鍵でボルトを作成 |
| ボルトのロック解除、統合ソケットの起動 |
| ボルト、ソケット、ウォレット、取引所のステータス表示(パスワード不要) |
取引所の認証情報
コマンド | 説明 |
| 設定済み取引所の一覧 |
| 取引所の認証情報を追加 |
| 取引所の認証情報を削除 |
対応取引所: mexc, gateio, bitget, kraken, binance, coinbase, okx
ウォレット
コマンド | 説明 |
| ウォレットアドレスとチェーンを表示 |
| ウォレットの認証情報を設定 |
| 秘密鍵を表示(確認が必要) |
支出ポリシー
コマンド | 説明 |
| 現在のポリシーを表示 |
| トランザクションあたりの最大USDC |
| 1日あたりの最大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?"セキュリティ
ボルト:
~/.openmm/vault.encにて AES-256-GCM 暗号化パスワード: インタラクティブなターミナルのみ — 設定ファイル、環境変数、CLIフラグには一切保存されません
ソケット:
/tmp/openmm.sockモード0600— ソケットが認証の境界となりますポリシー: 秘密鍵が使用される前に、ソケットレベルで支出制限が強制されます
分離: 秘密鍵はMCPクライアントプロセスのメモリには一切入りません — 署名はIPC経由で
openmm serveプロセス内で行われます
開発
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 Package — 支払い統合
MCP Specification — Model Context Protocolドキュメント
Base Network — USDC支払いのためのL2
ライセンス
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.48115 npm20MIT

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.780 npm2MIT- AlicenseNot gradedqualityDmaintenanceEnables AI-powered cryptocurrency trading and analytics across multiple exchanges and blockchains, with integrated Telegram bot and live trading capabilities.3MIT