openmm-mcp
@qbtlabs/openmm-mcp
OpenMM용 MCP 서버 — 모든 MCP 클라이언트를 통해 AI 에이전트에게 시장 데이터, 계정, 거래 및 전략 도구를 제공합니다.
두 가지 사용 방법
옵션 | 권장 대상 | 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에 연결됩니다. 하나의 볼트, 하나의 소켓으로 모든 클라이언트를 지원합니다.
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 |
| 일일 최대 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 패키지 — 결제 통합
MCP 사양 — Model Context Protocol 문서
Base 네트워크 — 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