AlgoVesta MCP Trading

---

AlgoVesta 运行着一个托管的 Model Context Protocol 服务，通过单个 HTTPS 端点连接 16 家加密货币交易所和 MetaTrader 5。Claude、ChatGPT、Cursor、Claude Code、Gemini CLI 或任何其他支持 MCP 的客户端，都可以读取余额、开仓和平仓、调整止损和止盈，并审计自身操作。

你的风险规则会编译为 JSON，并在请求离开模型后由服务端进行评估——不受任何可能诱使模型说出某些内容的因素影响。每个新密钥的起始资金都是 5,000 美元的模拟余额，每项操作都会返回一份 ed25519 签名、哈希链式收据。

**托管服务，闭源。**本仓库提供公开文档、工具参考和客户端配置。无需安装、构建或自行托管——只需连接到托管端点。

目录 — 概览 · 工作原理 · 快速开始 · 连接客户端 · 支持的 AI 客户端 · 使用示例 · 工具 · 安全模型 · 交易平台 · 性能和限制 · 端点 · 常见问题

概览

传输方式	通过 Streamable HTTP 使用远程 MCP
身份验证	密钥链接，或强制使用 PKCE（S256）和动态客户端注册（RFC 7591）的 OAuth 2.1
工具	20 个——13 个只读、3 个写入、4 个破坏性操作（参考）
交易平台	16 家加密货币交易所 · MetaTrader 5 · 内置模拟交易引擎
默认范围	paper——5,000 美元虚拟余额，工具集相同
实盘范围	仅在完成第二重身份验证后签发，由服务端强制执行
风险策略	编译为 JSON，由服务端确定性地评估
审计	每项操作都会生成 ed25519 签名、哈希链式收据，可独立验证
安装	无需安装。托管端点。
注册表	com.algovesta/trading——server.json 即为其清单

工作原理

flowchart LR
    A["AI client<br/>Claude, ChatGPT, Cursor, and more"]
    B["AlgoVesta MCP server<br/>scope, rate limit, idempotency"]
    C{"Policy wall<br/>evaluated server-side"}
    R["Refusal<br/>plus audit entry"]
    D["Execution"]
    E["16 crypto exchanges"]
    F["MetaTrader 5<br/>managed terminals"]
    G["Paper engine<br/>5,000 USD virtual"]
    H["ed25519-signed receipt"]

    A -->|MCP over HTTPS| B
    B --> C
    C -->|violates a rule| R
    C -->|allowed| D
    D --> E
    D --> F
    D --> G
    D --> H

模型是调用方，绝不是决策权威。模型决定请求什么；服务端决定如何处理。你的交易所 API 密钥不会离开 AlgoVesta，且创建时不包含提现权限——助手始终只持有具有限定范围且可撤销的 MCP 链接。

快速开始

1. 创建 AlgoVesta 账户，并在面板中打开 MCP Connection 选项卡。
2. 生成密钥。新密钥的默认范围为 paper；完整链接只会显示一次。
3. 将链接粘贴到 AI 客户端中，作为自定义 MCP 服务。

https://api.algovesta.com/u/avmcp_<your-key>/mcp

此 URL 是凭据。 请像对待密码一样妥善保管。如果泄露，请在面板中撤销；撤销会立即对新连接生效，并在几秒内关闭已打开的事件流。

偏好完整授权流程的客户端也可以改用 OAuth 2.1，地址为 https://api.algovesta.com/mcp。PKCE（S256）为必需项，并且支持动态客户端注册，因此大多数客户端都能自行完成配置。请参阅 docs/AUTHENTICATION.md。

连接客户端

下面提供了六个操作指南；其他客户端则在其用于填写远程 MCP 服务的字段中使用相同的 URL。

Claude — 网页版、桌面版、iOS、Android

Settings -> Connectors -> Add custom connector，粘贴 URL，然后在 Claude 询问时允许使用这些工具。操作指南

Claude Code

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

操作指南

ChatGPT

Settings -> Connectors -> Advanced -> Developer mode -> Create，传输方式选择 Streamable HTTP。自定义连接器是 OpenAI 付费套餐提供的功能。操作指南

Cursor

~/.cursor/mcp.json，或项目中的 .cursor/mcp.json — 文件

{
  "mcpServers": {
    "algovesta": { "url": "https://api.algovesta.com/u/avmcp_<your-key>/mcp" }
  }
}

VS Code — GitHub Copilot

.vscode/mcp.json — 文件

{
  "servers": {
    "algovesta": {
      "type": "http",
      "url": "https://api.algovesta.com/u/avmcp_<your-key>/mcp"
    }
  }
}

Gemini CLI

~/.gemini/settings.json — 文件。仅限 CLI；Gemini 网页应用不接受自定义 MCP 服务。

{
  "mcpServers": {
    "algovesta": { "httpUrl": "https://api.algovesta.com/u/avmcp_<your-key>/mcp" }
  }
}

其他客户端

你会遇到的三种配置格式，以及 curl 连接检查：examples/other-clients.md

支持的 AI 客户端

这是一个基于 Streamable HTTP 的标准远程 MCP 服务，因此任何支持远程 MCP 的客户端都可以连接。下方各客户端均有自己的相关支持文档——每行链接到该客户端自己的配置文档，具体字段名称可在其中查到。

助手和聊天应用 — 8

客户端	MCP 文档
Claude — 网页版、桌面版、iOS、Android	自定义连接器
ChatGPT — 开发者模式连接器	OpenAI MCP 文档
Microsoft Copilot Studio Agent	通过 MCP 扩展
Goose (Block)	block.github.io/goose
LibreChat	LibreChat 中的 MCP
Open WebUI	docs.openwebui.com
Cherry Studio	docs.cherry-ai.com
Raycast	raycast.com

编码 Agent 和 IDE — 19

客户端	MCP 文档
Claude Code	Claude Code MCP
OpenAI Codex CLI	Codex MCP
Gemini CLI	Gemini CLI 中的 MCP 服务
Cursor	Cursor MCP
VS Code — GitHub Copilot	VS Code 中的 MCP 服务
Windsurf	Cascade MCP
Zed	Zed MCP
Cline	连接到远程服务
Roo Code	在 Roo 中使用 MCP
Kilo Code	在 Kilo Code 中使用 MCP
Continue	MCP 深入解析
JetBrains AI Assistant	JetBrains IDE 中的 MCP
Warp	Warp MCP
Amazon Q Developer	通过 Amazon Q 使用 MCP
Kiro (AWS)	Kiro MCP
Sourcegraph Amp	Amp 手册
Trae	Trae MCP
PostHog Code	posthog.com/code
Archestra.AI	archestra.ai

框架、自动化和开发者工具 — 6

客户端	MCP 文档
OpenAI Agents SDK	Agents SDK 中的 MCP
fast-agent	evalstate/fast-agent
n8n — MCP 客户端工具节点	docs.n8n.io
Postman	MCP 请求
MCP Inspector	modelcontextprotocol/inspector
MCPJam	mcpjam.com

该声明的适用范围。 我们已针对该服务端到端验证 Claude。列出其他客户端，是因为它们的文档说明支持远程 MCP，并不代表我们逐一测试过。客户端支持情况也变化很快，而且某些客户端可能会要求付费方案才能使用连接器（ChatGPT 如此），或仅支持通过 CLI 使用（Gemini 网页应用不接受自定义 MCP 服务）。如果列表中的客户端无法正常与我们配合，或有客户端遗漏，请提交问题。

使用效果

你无需按名称调用工具，只需用日常语言提出请求，由助手选择工具。

你说	助手会调用
“我现在的账户情况如何？这个月以来表现怎样？”	get_portfolio_context — 一次调用即可查看所有交易所、MT5 账户和模拟账户，然后调用 get_trade_history
“我连接的交易所上，BTC 的交易价格是多少？”	compare_venues — 获取测得的价格，以及在有公开数据时获取买卖价差
“如果我在 Binance 开立 0.05 BTC 的多头仓位，并设置 2% 的止损，需要多少成本？我的规则会允许吗？”	simulate_order — 模拟执行，包括策略判定
“好，开仓吧——止损设在下方 2%，目标设在上方 4%。”	place_order
“把我的 ETH 仓位止损上调到盈亏平衡点。”	modify_position
“平掉 SOL 多头仓位的一半。”	close_position — 加密货币支持部分平仓；MT5 则是全部平仓
“每笔交易的风险绝不超过 1%，最多持有 3 个仓位，日内回撤达到 5% 后就停止交易。”	compile_policy — 返回供你审批的易读 JSON
“给我看看上一笔订单的收据，并验证一下。”	verify_receipt — 根据你可以自行获取的公钥验证签名和哈希链
“用 1% 的风险上限，重新运行我最近 90 天的信号。”	先调用 simulate_policy，再调用 get_job_status

它也会拒绝某些请求。 “为该策略开启自动交易” — 拒绝；任何作用域内的可写字段都不包含 auto_trade。“替我在 Kraken 上交易”，但未连接 Kraken — 返回 VENUE_NOT_CONNECTED，而不是凭空猜测。“不设止损，直接开仓” — 拒绝，且不会回退到任何已保存的默认值。

使用 paper 密钥时，每次操作都会使用相同的工具集，在 5,000 美元的虚拟余额上运行，因此在接触真实资金前，可以先完整演练整个工作流。

工具

共 20 个工具。read 范围适用于任何密钥；其他工具则受 paper / live 范围限制。

完整工具列表

工具	范围	类型	用途
get_portfolio_context	read	只读	一次调用即可查看所有已连接账户
get_market_price	read	只读	实时报价，并报告数据新鲜度
get_trade_history	read	只读	查看加密货币、MT5 和模拟交易中的已平仓交易及表现
compare_venues	read	只读	根据实测价格和价差为已连接的交易所排名
simulate_order	read	只读	试运行订单，并提供策略判定结果
place_order	paper / live	破坏性操作	开仓（实盘加密货币仅支持市价单）
compile_policy	read	只读	将自然语言规则转换为策略预览
list_open_orders	read	只读	查看待成交限价单（模拟交易簿）
cancel_order	paper / live	破坏性操作	取消待成交订单
close_position	paper / live	破坏性操作	全部或部分平仓（MT5 仅支持全平）
modify_position	paper / live	写入	调整止损和止盈
list_strategies	read	只读	查看你的 TradingView 策略及实盘交易是否已开启
create_strategy	paper / live	写入	创建新策略，始终默认关闭实盘交易
update_strategy	paper / live	写入	更改策略设置（不能修改 auto_trade）
verify_receipt	read	只读	验证签名和哈希链
replay_channel	read	只读	根据你的规则回测 Telegram 频道
backtest_my_signals	read	只读	使用不同设置重放你过去的信号（排队任务）
simulate_policy	read	只读	将风险策略应用于你实际平仓的交易（排队任务）
import_tradingview_backtest	read	只读	使用真实费用和滑点重新计算 TradingView 交易导出数据（排队任务）
get_job_status	read	只读	查看排队任务的进度和结果

其中两个工具值得特别说明，因为它们拒绝执行的操作正是重点：

• compare_venues 不会为你的订单选择交易场所。 它会报告实时价格，以及公布买卖价差的交易场所所提供的价差。它无法得知你的费率等级、订单簿深度或你将承担的滑点，并且会在每次响应中明确说明这一点。未公布买卖价差的交易场所会单独列出，而不会被当作价差为零来排名。你仍需在 place_order 中自行指定交易所。
• create_strategy / update_strategy 无法开启实盘交易。 新策略始终以关闭 auto_trade 的状态创建；而 auto_trade 不属于可写字段集，无论助手受到何种请求或劝说，都无法设置该字段。单笔订单是你可以看到的一次操作；策略则会在对话结束后继续交易，因此是否启用策略仍由人类在面板中决定。出于同样的原因，ip_allowlist 也不能修改：它是用于验证信号来源的第二重校验因素。

完整参考文档（含说明和 JSON Schema）：docs/TOOLS.md · 机器可读版本：tools.json

安全模型

AI 是调用方，而非权威。完整模型：docs/SAFETY.md。

控制措施	含义
默认使用模拟模式	每个新密钥都从 paper 范围开始，虚拟余额为 $5,000。使用真实资金是单独且经过审慎确认的操作：只有通过第二因素验证（TOTP；对于通过面板创建的密钥，也可使用电子邮件验证码；通过 OAuth 时则必须使用 TOTP）后才会签发 live 范围，并且由服务端强制执行，毫无例外。
服务端策略防护墙	每笔交易的最大风险、订单规模上限、每日亏损上限、持仓数量、杠杆上限、交易平台／交易品种／方向限制——这些策略会编译为 JSON，并在请求离开模型后进行确定性评估。提示词注入可以改变模型发送的内容，但无法改变服务端的评估方式。
必须设置止损	未设置止损且没有已保存的默认值时，订单会被拒绝。之后也无法移除止损。在外汇／MT5 上，还必须设置止盈。
幂等性	每个与订单相关的工具（包括只读的 simulate_order，因此同一个密钥可从模拟延续到下单）都要求使用由客户端生成的幂等密钥。重复请求会重放已存储的响应，而不会重复执行操作。
签名回执	每项操作都会返回经过 ed25519 签名且采用哈希链的回执，可通过公钥端点进行验证。
紧急停止开关与按密钥撤销	可一次冻结所有操作，也可撤销某个客户端而不影响其他客户端。
结构性租户隔离	工具完全没有身份参数。账户由经过身份验证的连接确定，因此无论是误解指令的模型还是攻击者，都无法通过提供参数访问其他账户。
不提供提款途径	交易平台 API 密钥创建时不会授予提款权限，并且会留在 AlgoVesta 内部，使用 AES-256 加密。AI 始终只能持有权限受限且可撤销的 MCP 链接。

交易平台

加密货币（16） — Binance · Bybit · OKX · KuCoin · Gate.io · Bitget · Kraken · Coinbase · BingX · Hyperliquid · Backpack · HTX · BloFin · Phemex · WOO X · CoinEx

外汇、金属、指数 — MetaTrader 5，无需安装：AlgoVesta 在自有托管服务器上运行 MT5 终端，并全天候连接到你的经纪商。

模拟交易 — 内置模拟交易引擎，虚拟余额为 $5,000。

六家交易所——Binance、Bybit、OKX、Gate.io、KuCoin 和 Bitget——均已通过真实资金在期货和现货交易中完成端到端验证，并确认止损和止盈已在交易所端生效。每家交易所都有各自的特性，这些差异是有意设计的，并非功能缺失：Bybit 和 Bitget 的现货交易不接受第二个止盈档位；OKX 现货交易通过原始 API 路由，避免现金账户悄然变成保证金账户；Binance 现货交易会在买入前强制执行最低名义金额；KuCoin 市价买单以成本模式下单。只有在你连接某家交易所后，该交易所才会对 AI 开放——如果请求使用尚未连接的交易所，将返回 VENUE_NOT_CONNECTED，而不会猜测。

性能与限制

限制	数值
所有工具调用，每个密钥	60 次／分钟
place_order	10 次／分钟
replay_channel	5 次／小时（结果缓存 24 h）

实测数据，非营销宣传——数据于 2026 年 8 月测得；平均值与 algovesta.com 上公布的数据一致：

阶段	实测数据
请求接收与解析	17–67 ms（中位数 38，n=6）
MetaTrader 5 端到端	平均约 1.2 秒，包括止损和止盈（单笔实盘演示订单：849 ms）
加密货币交易所端到端	平均约 4.1 秒，包括止损和止盈（单笔实盘订单：2,785 ms）
模拟交易引擎	中位数 318 ms（n=18，最小值 284，最大值 769）

在你的 AI 客户端内耗费的时间——模型思考以及等待你确认——不计在内，而且通常占据主要部分。此服务并非低延迟执行平台，也不以此为卖点。

端点

用途	URL
MCP — 密钥链接	https://api.algovesta.com/u/avmcp_<key>/mcp
MCP — OAuth 2.1	https://api.algovesta.com/mcp
实时事件（SSE）	https://api.algovesta.com/mcp/events · /u/avmcp_<key>/events
OAuth 元数据	/.well-known/oauth-authorization-server · /.well-known/oauth-protected-resource
回执公钥	/mcp/receipts/pubkey
工具架构	https://algovesta.com/mcp/tools.json

已在官方 MCP 注册表中发布，名称为 com.algovesta/trading；本仓库中的 server.json 即为该清单。

常见问题

Claude、ChatGPT 或 Cursor 能否在我的交易所账户上实际下单？

可以——只要你向它提供一个具有 live 范围的密钥，而该范围只有在通过第二因素验证后才会发放。在此之前，同一个助手会使用 $5,000 的模拟余额运行，工具完全相同，因此你可以在触及任何真实资金之前演练整个工作流。

我必须把交易所 API 密钥交给 AI 吗？

不需要，而且你绝不应该把 API 密钥交给任何工具。你的 API 密钥保存在 AlgoVesta 内部并经过加密，创建时不带提现权限。助手只会持有 MCP 链接——该链接具有范围限制、速率限制、策略检查、可单独撤销，且无法用于将资金转出交易所。

提示词注入能让 AI 无视我的风险规则吗？

它可以改变模型请求的内容，但不能改变服务端的响应方式：模型发出请求后，代码会评估你的规则，而提示词无法触及这部分代码；违反规则的请求会被拒绝并写入审计日志。应当明确说明这项保证的边界——它涵盖规则评估、范围和账户隔离，但不涵盖助手之后对你说的话。

如果模型误调用了两次 place_order，会发生什么？

不会重复执行。每个写入工具都要求提供幂等键；重复使用同一个键时，系统会返回已存储的响应，而不会再次执行操作。

如何立即停止所有操作？

面板中的紧急停止开关（POST /api/mcp/freeze）会立即停止所有操作；之后每个工具都会返回 user_frozen。若要切断单个客户端的连接，只需撤销对应密钥。

示例

examples/ 中提供了可直接使用的文件：

• TradingView 警报模板：六种 JSON 消息（基本入场、多档止盈、带持仓状态的 Pine 策略、平仓、MT5 外汇、带保证金和杠杆的加密货币），以及 webhook 接收器使用的字段参考。
• Telegram 信号解析语料：30 条合成信号消息及其预期解析结果，可用于测试你自己的跟单工具，或了解 AlgoVesta 解析器支持哪些格式。
• MCP 客户端代码：精简的 Python 和 Node.js 程序，可通过密钥链接连接、读取投资组合并提交模拟订单。
• 客户端配置：Cursor、VS Code、Gemini CLI。

支持

账户和交易问题：支持 · [email protected] 漏洞报告：SECURITY.md 无法连接的客户端，或上方列表中没有列出的客户端：提交 issue

合规

AlgoVesta 不生成信号，不持有、接收或转移客户资金，也不提供投资建议。交易存在风险；自动化并不能消除风险。每个新密钥都从模拟交易开始。

许可证

版权所有 (c) 2026 AlgoVesta。本仓库中的文档和配置示例依据 CC BY 4.0 许可。AlgoVesta MCP 服务本身为专有且托管的服务；本仓库不包含服务源代码。