Skip to main content
Glama

@qbtlabs/openmm-mcp

npm version npm downloads License: MIT Ask DeepWiki

📚 문서 · 🤖 AI 스킬 포털 · 🔌 API 참조

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

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

/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 키

OPENMM_SOCKET만

Claude Code

env에 API 키

OPENMM_SOCKET만

Cursor

env에 API 키

OPENMM_SOCKET만

Windsurf

env에 API 키

OPENMM_SOCKET만

모든 클라이언트는 동일하게 실행 중인 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

보안 속성

속성

방식

저장 시 키 암호화

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

클라이언트 메모리에 키 미저장

MCP 프로세스는 소켓 경로만 보유

구성 파일에 키 미저장

구성 파일 어디에도 API 키나 개인 키 없음

프로세스 격리

서명은 AI 에이전트 프로세스가 아닌 openmm serve에서 발생

정책 시행

개인 키 접근 전 지출 한도 확인

메모리 안전성

signAndWipe() — 키는 한 번만 사용되고 즉시 범위에서 제거

결제 흐름

  1. 에이전트가 도구를 호출합니다.

  2. 서버가 가격과 함께 402 Payment Required를 반환합니다.

  3. openmm serve가 EIP-3009 승인에 서명합니다(가스비 없음 — ETH 불필요).

  4. 서버가 온체인으로 결제를 제출하고 데이터를 반환합니다.

도구 가격

카테고리

도구

가격 (USDC)

무료

list_exchanges

$0.00

읽기

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

$0.001

쓰기

create_order, cancel_order, cancel_all_orders, start_grid_strategy, stop_strategy

$0.01


사용 가능한 도구 (15)

도구

설명

매개변수

시장 데이터

list_exchanges

지원되는 거래소 목록

—

get_ticker

실시간 가격, 매수/매도 호가, 스프레드, 거래량

exchange, symbol

get_orderbook

오더북 깊이 (매수/매도)

exchange, symbol, limit?

get_trades

최근 거래 및 매수/매도 요약

exchange, symbol, limit?

get_ohlcv

OHLCV 캔들스틱 데이터

exchange, symbol, timeframe?, limit?

계정

get_balance

계정 잔액 (전체 또는 필터링)

exchange, asset?

list_orders

미체결 주문 (전체 또는 심볼별)

exchange, symbol?

거래

create_order

지정가 또는 시장가 주문 생성

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

cancel_order

ID로 주문 취소

exchange, symbol, orderId

cancel_all_orders

특정 페어의 모든 주문 취소

exchange, symbol

Cardano DEX

get_cardano_price

DEX에서 집계된 토큰 가격

symbol

discover_pools

유동성 풀 탐색

symbol, minLiquidity?

전략

start_grid_strategy

그리드 트레이딩 시작

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

stop_strategy

실행 중인 전략 중단

strategyId, cancelOrders?

get_strategy_status

전략 상태 확인

strategyId


CLI 참조

설정 및 서버

명령어

설명

openmm-init

볼트 생성, 지갑 생성/가져오기, 거래소 추가

openmm-init --import <key>

기존 개인 키로 볼트 생성

openmm serve

볼트 잠금 해제, 통합 소켓 시작

openmm-status

볼트, 소켓, 지갑 및 거래소 상태 표시 (비밀번호 불필요)

거래소 자격 증명

명령어

설명

openmm-exchange list

구성된 거래소 목록

openmm-exchange add <id>

거래소 자격 증명 추가

openmm-exchange remove <id>

거래소 자격 증명 제거

지원 거래소: mexc, gateio, bitget, kraken, binance, coinbase, okx

지갑

명령어

설명

openmm-wallet info

지갑 주소 및 체인 표시

openmm-wallet set

지갑 자격 증명 설정

openmm-wallet export

개인 키 표시 (확인 필요)

지출 정책

명령어

설명

openmm-policy show

현재 정책 표시

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

트랜잭션당 최대 USDC

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

일일 최대 USDC

openmm-policy set allowed-chains <chains>

쉼표로 구분된 체인 ID

openmm-policy reset

모든 정책 제한 초기화

고급

명령어

설명

openmm-vault info

볼트 메타데이터 표시

openmm-vault change-password

볼트 비밀번호 변경

openmm-vault export

모든 자격 증명 내보내기 (위험)

openmm-vault destroy

볼트 삭제


사용 예시

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

리소스

라이선스

MIT

호스팅 배포

Fronteir AI에서 호스팅 배포를 이용할 수 있습니다.

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