用 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 能做什么、不能做什么,见交易员对接概览。