跳转到内容

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