/ ディレクトリ / プレイグラウンド / agent-trade-kit
● コミュニティ okx ⚡ 即起動

agent-trade-kit

作者 okx · okx/agent-trade-kit

OKX公式準拠のトレーディングMCP — スポット、スワップ、先物、オプション、グリッド/DCAボットに対応する112のツール — リードオンリーモードとローカル専用の認証情報保管を備えています。

agent-trade-kitはOKXトレーディング向けのNode MCPです。マーケットデータ、スポット、無期限スワップ、先物、オプション、収益、アカウント、アルゴ/ボット戦略を網羅し、8モジュールに112のツールを搭載しています。認証情報はローカルに保存され、クラウド中継はありません。分析専用の--read-onlyフラグも提供されています。

なぜ使うのか

主な機能

ライブデモ

実際の動作

agent-trade-kit.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agent-trade-kit": {
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "agent-trade-kit",
      "command": "npx",
      "args": [
        "-y",
        "agent-trade-kit"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "agent-trade-kit": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "agent-trade-kit"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add agent-trade-kit -- npx -y agent-trade-kit

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: agent-trade-kit

取引判断前にアセットをリサーチする(リードオンリー)

👤 デューデリジェンスを行う暗号資産トレーダー ⏱ ~20 min advanced

使うタイミング: ポジションを検討しており、誤発注のリスクなしにチャート+インジケーター+板情報のスナップショットを一度に確認したい場合。

前提条件
  • OKX APIキー(リードオンリースコープ) — OKX > API > リードオンリー権限でキーを作成
フロー
  1. リードオンリーモードで開始
    Configure agent-trade-kit with --read-only. Confirm trade tools are disabled.✓ コピーしました
    → リサーチツールのみ有効
  2. データを取得
    For SOL-USDT: 4h candles last 30 days, RSI(14), MACD, current funding rate, top-of-book depth, and open interest trend.✓ コピーしました
    → インジケータースタック
  3. 統合分析
    What's the short-term technical picture and is it aligned with funding/OI?✓ コピーしました
    → 分析結果

結果: 執行リスクなしで情報に基づいた見解を得られます。

注意点
  • テクニカル分析は予測エンジンではない — 複数の判断材料の一つとして使用し、単独の売買シグナルとしない

保守的なパラメーターでグリッドボットを設定する

👤 グリッド戦略を検討中の暗号資産トレーダー ⏱ ~30 min advanced

使うタイミング: レンジ相場で推移すると見込む通貨ペアにグリッドを設定したい場合。

前提条件
  • 資金入金済みのOKXアカウント — 実際の資金が必要です — 慎重に操作してください
  • フルAPIキー(トレードスコープ) — OKX > API; 出金権限は絶対に有効にしないこと
フロー
  1. プランニング
    For ETH-USDT spot: analyze last 30d range. Propose a grid: 40 levels, range $2800-$3400, $50 per grid investment. Show projected returns.✓ コピーしました
    → 前提条件付きのグリッドプラン
  2. 確認して作成
    Before placing: confirm parameters. If I say 'go', create the grid bot; otherwise abort.✓ コピーしました
    → 明示的な確認ゲート

結果: リスクを管理したグリッドボットが稼働します。

注意点
  • レンジブレイクアウト=グリッドが損失を出す — レンジ外にストップロス価格を設定し、毎週見直す
  • LLMが注文サイズを誤る — 実際の資金が失われる — 小さいサイズから開始し、確認前にすべてのパラメーターを検証する

ポートフォリオの損益とオープンポジションを確認する

👤 アクティブトレーダー ⏱ ~5 min intermediate

使うタイミング: 朝の確認 — 何のポジションを持っているか、損益はどうか、証拠金にリスクはないか。

フロー
  1. アカウント状態を取得
    List all open positions (spot + swap + futures) with unrealized PnL. Show account equity + maintenance margin ratio.✓ コピーしました
    → ポートフォリオスナップショット
  2. リスクチェック
    Which position is at highest liquidation risk? How far from its liq price?✓ コピーしました
    → リスクランキング

結果: リスクを把握した上での朝の確認が完了します。

組み合わせ

他のMCPと組み合わせて10倍の力を

agent-trade-kit + filesystem

税務・監査用にすべての取引執行をローカルにログ記録

After each trade, append instrument/side/size/price/ts to ~/trades/YYYY-MM.csv.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
market_candles instrument, bar, limit? 価格データの取得 1 API call
market_book instrument, depth 流動性の確認 1 API call
account_balance アカウント状態の確認 1 API call
spot_place_order instrument, side, size, type, price? スポット執行 — 破壊的操作、必ず確認! 1 API call + 実際の資金
grid_bot_create instrument, range, levels, total_investment グリッド戦略の開始 — 破壊的操作、必ず確認! 1 API call + 実際の資金

コストと制限

運用コスト

APIクォータ
OKX APIにはエンドポイントごとのレート制限があります
呼び出しあたりのトークン
ローソク足や板情報はデータ量が大きくなる場合があります — limitで絞り込んでください
金額
MCPは無料です。取引にはOKXの手数料+実際の資金リスクが発生します。
ヒント
ツールリストを確認し、プロンプト操作に自信が持てるまで--read-onlyを使用してください。

セキュリティ

権限、シークレット、影響範囲

最小スコープ: API key with NO withdrawal permission, ever
認証情報の保管: okx config initによるローカル保存 — ディスク上に保持されます
データ送信先: OKX APIへ送信。アカウントデータはご利用のLLMプロバイダーへ送信されます
絶対に付与しない: Withdrawal permission on an API key used with an LLM

トラブルシューティング

よくあるエラーと対処法

Signature invalid

APIキー/シークレット/パスフレーズの不一致です。okx config initを再実行してください。また、サーバー時刻も確認してください(APIは時刻に敏感です)。

Insufficient balance for order

トレーディングアカウントに資金を振り替えてください(OKXには複数のウォレットがあります)。

Tool missing when expected

モジュール単位のフィルタリングがブロックしている可能性があります。コンフィグを確認してください。

代替案

agent-trade-kit 他との比較

代替案代わりに使う場面トレードオフ
Hummingbot / custom bot frameworksLLMを使わない自動売買を行いたい場合コードベース、LLMなし。より決定論的な動作
Direct OKX API完全なコントロールが必要で、自分で監査できる場合独自のラッパーを構築する必要がある

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る