用 AI agent 交易
jv 內建一個 MCP 伺服器:jv mcp,stdio 模式,伺服器名稱 jasper-vault。AI 使用者端接入後,agent 呼叫 MCP 工具,每個工具在本機執行對應的 jv 指令,簽名用的是同一份本機授權。
- 安裝 jv CLI。
- 建議先在自己的終端機裡執行
jv enable完成授權。agent 也可以用wallet_setup工具發起授權,但需要依下文在 MCP 設定裡設定BASE_HTTP_RPC_URL。
安裝 skill 和 MCP 設定:jv install
Section titled “安裝 skill 和 MCP 設定:jv install”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
Section titled “Claude Code”安裝後在 Claude Code 裡輸入 /mcp,檢查清單裡有沒有 jasper-vault。如果沒有,用 Claude Code 內建的指令註冊:
Cursor
Section titled “Cursor”jv install 會在 ~/.cursor/mcp.json 裡加入:
OpenClaw
Section titled “OpenClaw”jv install --ai openclaw 只安裝 skill,不寫入 MCP 設定。skill 要求 agent 透過 jasper-vault 的 MCP 工具交易,所以還需要依 OpenClaw 的方式,把 jv mcp 註冊為名稱是 jasper-vault 的 MCP 伺服器。
讓 agent 發起授權和提領
Section titled “讓 agent 發起授權和提領”wallet_setup(授權)和 withdraw_via_browser(提領)這兩個工具執行時需要 BASE_HTTP_RPC_URL。MCP 伺服器執行 jv 指令時會帶上它自己的環境變數,所以要把這個變數寫進 MCP 設定。
Claude Code:
Cursor:在 ~/.cursor/mcp.json 的 jasper-vault 下加一項 env:
只在自己的終端機裡授權和提領的話,不用做這一步。
MCP 工具
Section titled “MCP 工具”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 能做什麼、不能做什麼,見交易員對接概覽。