跳到內容

用 AI agent 交易

jv 內建一個 MCP 伺服器:jv mcp,stdio 模式,伺服器名稱 jasper-vault。AI 使用者端接入後,agent 呼叫 MCP 工具,每個工具在本機執行對應的 jv 指令,簽名用的是同一份本機授權。

  1. 安裝 jv CLI。
  2. 建議先在自己的終端機裡執行 jv enable 完成授權。agent 也可以用 wallet_setup 工具發起授權,但需要依下文在 MCP 設定裡設定 BASE_HTTP_RPC_URL。
jv install --ai claude            # Claude Code,skill 裝在目前目錄
jv install --ai claude --global   # Claude Code,skill 裝在使用者目錄
jv install --ai cursor            # Cursor,skill 裝在目前目錄
jv install --ai cursor --global   # Cursor,skill 裝在使用者目錄
jv install --ai openclaw          # OpenClaw
jv install                        # 三個平台都裝,skill 裝在使用者目錄

jv install 會安裝一份 skill(告訴 agent 如何使用這些工具),並為 Claude Code 和 Cursor 寫入 MCP 設定:

平台 skill 位置 MCP 設定
Claude Code .claude/skills/jasper-vault-cli/,加 --global 時為 ~/.claude/skills/jasper-vault-cli/ 寫入 ~/.claude/settings.json 的 mcpServers
Cursor .cursor/skills/jasper-vault-cli/,加 --global 時為 ~/.cursor/skills/jasper-vault-cli/ 寫入 ~/.cursor/mcp.json 的 mcpServers
OpenClaw ~/.openclaw/skills/jasper-vault-cli/ 不寫入
  • MCP 設定一律寫在使用者目錄,--global 只決定 skill 裝在哪裡。
  • 目標位置已經有 skill 時會報錯,加 --force 覆寫。升級 CLI 後,建議加 --force 重新安裝一次,讓 skill 和新版本保持一致。
  • 安裝後重新啟動 AI 使用者端。
  • 解除安裝用 jv uninstall --ai claude(或 cursor、openclaw、all)。skill 裝在使用者目錄的,解除安裝時也要加 --global。

安裝後在 Claude Code 裡輸入 /mcp,檢查清單裡有沒有 jasper-vault。如果沒有,用 Claude Code 內建的指令註冊:

claude mcp add --scope user --transport stdio jasper-vault -- jv mcp

jv install 會在 ~/.cursor/mcp.json 裡加入:

{
  "mcpServers": {
    "jasper-vault": { "command": "jv", "args": ["mcp"] }
  }
}

jv install --ai openclaw 只安裝 skill,不寫入 MCP 設定。skill 要求 agent 透過 jasper-vault 的 MCP 工具交易,所以還需要依 OpenClaw 的方式,把 jv mcp 註冊為名稱是 jasper-vault 的 MCP 伺服器。

wallet_setup(授權)和 withdraw_via_browser(提領)這兩個工具執行時需要 BASE_HTTP_RPC_URL。MCP 伺服器執行 jv 指令時會帶上它自己的環境變數,所以要把這個變數寫進 MCP 設定。

Claude Code:

claude mcp add --scope user -e BASE_HTTP_RPC_URL=https://mainnet.base.org --transport stdio jasper-vault -- jv mcp

Cursor:在 ~/.cursor/mcp.json 的 jasper-vault 下加一項 env:

{
  "mcpServers": {
    "jasper-vault": {
      "command": "jv",
      "args": ["mcp"],
      "env": { "BASE_HTTP_RPC_URL": "https://mainnet.base.org" }
    }
  }
}

只在自己的終端機裡授權和提領的話,不用做這一步。

jv mcp 提供 17 個工具:

類別 工具 對應指令
交易 create_order jv order create
交易 close_position jv order close
交易 protect_order jv order protect
交易 set_take_profit jv tp set
交易 set_stop_loss jv sl set
查詢 list_orders jv orders list
查詢 get_order jv orders get
查詢 get_order_stats jv orders stats
查詢 get_price jv price
查詢 get_job_status jv job status
限價單 list_limit_orders jv limit-order list
限價單 get_limit_order_status jv limit-order status
限價單 cancel_limit_order jv limit-order cancel
錢包與資金 wallet_setup jv enable
錢包與資金 deposit_via_browser jv deposit
錢包與資金 withdraw_via_browser jv withdraw
其他 check_update 檢查 CLI 有沒有新版本
  • MCP 裡沒有列出市場的工具,也沒有查看錢包資訊的工具。指令裡請直接寫交易代碼,例如 JVBTC,完整清單用 jv market list 查看。查詢限價單時要提供錢包地址,可以用 jv wallet info 裡的 eoa。
  • 一般工具最多執行 90 秒。wallet_setup、deposit_via_browser、withdraw_via_browser 最多執行 16 分鐘,等你在瀏覽器裡完成簽名。
  • CLI 有新版本時,工具結果末尾會多一則升級提示。
你說 agent 呼叫
JVBTC 現在多少錢? get_price
用 100 JVUSD 保證金、20 倍槓桿,市價開 JVBTC 多單 create_order
JVBTC 在 60000 掛一張限價多單,保證金 50,10 倍槓桿,2 小時有效 create_order,帶限價和有效期
為訂單 42 加上 PPO 保護,OTM 第 3 檔,8 小時 protect_order
訂單 43 是空單,停利 58000,停損 66000 set_take_profit、set_stop_loss,方向為空單
列出我現在的持倉 list_orders
把訂單 42 平掉 / 全部平倉 close_position
從 Base 充值 200 USDC deposit_via_browser,回傳一個網址,在網頁上用錢包簽名
  • 用一個單獨的錢包,只放準備交易的資金。
  • 在 AI 使用者端裡保留下單、平倉、提領類工具的呼叫確認,不要設成自動核准。確認前看清方向、交易代碼、保證金和槓桿。
  • 不要讓 agent 讀取、顯示或上傳 ~/.jaspervault/ 下的檔案,也不要把 key 檔案的內容貼進對話。
  • agent 提供授權、充值或提領網址時,在錢包裡簽名前核對簽名內容,例如金額、地址和到期時間。
  • 不要讓同一個 agent 一邊讀取來路不明的網頁或文件,一邊握有下單工具。內容裡藏著的指令可能誘導它下單。
  • 下單只有回傳 "status": "completed"(市價單、加保護)或 limitOrderId(限價單、停利停損單)才算明確成功。回傳 timeout、failed 或網路錯誤時,訂單都可能已經成交,先用 list_orders 和 list_limit_orders 查清結果,再決定要不要重新下單。
  • 減過倉的倉位,close_position 可能在平倉後反向開倉,建議在網頁端平倉。用 close_position 平倉後,用 list_orders 確認倉位已經平掉,並且沒有新開的反向倉位。原因見用命令列交易裡的「加倉、減倉與平倉」一節。
  • 委託 key 能做什麼、不能做什麼,見交易員對接概覽。