SuperAPI AI 工具集

ctrader-mcp-servers

智能体与模型

查看项目

更新于 10-15 15:13

技能介绍

用途

该技能面向任何与 cTrader MCP 服务器交互的场景,帮助识别当前绑定的是哪个服务器家族,并按正确的单位、标识符与参数约定调用工具,避免因编码差异导致的错误下单、错误价格或 schema 拒绝。

主要能力

  • 工具面路由:通过工具名与响应 DTO 形状区分本地 HTTP(ctrader-local-mcp)与远程 HTTP(ctrader-remote-mcp)。本地指纹包括 ping、get_accounts_list、list_charts、listChartIndicators、listPlugins、show_notification、get_server_time,成交量以 units 计,时间戳为带 Z 的 ISO 8601,品种用字符串名。远程指纹包括 get_version、get_assets、以整数 symbolId 为键的工具、响应含 moneyDigits,成交量以 cents 计,价格以 pipettes 计。
  • 单位与标识符约定:列出两个服务器在成交量、价格、金额、时间戳、品种标识符、止损止盈形式上的编码差异,并给出转换脚本。
  • 止损止盈形式:下单类工具(place_market_order 等)使用点数距离(stopLossPips/takeProfitPips),持仓修改类工具(amend_position)使用绝对价格(stopLoss/takeProfit),约定取决于所调用的工具而非服务器。
  • 动态杠杆保证金:按分层杠杆逐层计算并求和,示例与脚本 scripts/tiered_margin.py。
  • 货币换算:当报价货币与账户货币不同时,通过最短即期汇率链换算,脚本 scripts/conversion_rate.py。
  • 账户与风险语义:对冲与净额账户区别、强平与保证金水平、隔夜利息计提时机(周三常三倍计息)。
  • 已知怪癖台账:记录 Q-R10(amend_position 省略一条腿会删除该腿)、Q-R4(MARKET 拒绝绝对 SL/TP,需用相对值或两步法)、Q-R1(period 枚举为 9 个值而非 26 个)、Q-L2(本地 get_pending_orders 中 SL 为绝对价、TP 为原始点数)、Q-K19(pipettes 与显示值混淆导致静默市价成交)等,每条附带检测、规避、验证修复与移除条件。
  • 自愈手册:包含飞行前检查、飞行后验证、错误分类矩阵、未知怪癖决策树与命名恢复模式(P-AMEND-SAFE、P-REMOTE-MARKET-RELATIVE、P-REMOTE-MARKET-2STEP、P-REMOTE-MARKET-RANGE、P-LOCAL-OLDEST-FIRST、P-REMOTE-HISTORY-CHUNK)。
  • 交易者工作流:W0 会话引导自动运行;W1 按风险百分比计算仓位、W2 交易前简报、W3 交易成本比较、W4 下单并在图表标注风险回报、W5 多窗口历史回填、W6 安全平仓,由用户意图触发。
  • 配套脚本:scripts/pip_math.py、scripts/position_sizing.py、scripts/tiered_margin.py、scripts/conversion_rate.py、scripts/units_encoding.py,均仅接受 CLI 参数、输出 JSON 到 stdout、诊断到 stderr,支持 --help。

使用方式

每次 cTrader 相关交互开始时先应用路由规则并缓存结果;根据绑定的工具面读取 references/local-http-server.md 或 references/remote-http-server.md(两者都绑定则都读)。遇到超出单次乘加的数学计算时调用 scripts/ 下的脚本。当用户请求匹配 W1–W6 触发条件时,读取 references/trader-workflows.md 并按其配方执行。遇到偏离 MCP JSON-Schema 与台账的意外行为时,遵循 references/self-healing-playbook.md,不要即兴处理。

适用场景

需要与 cTrader 交易平台或远程 REST 代理交互的自动化交易、图表与指标操作、cBot、多账户管理、无头交易、品种扫描、移动止损、历史数据回填、仓位与保证金计算、货币换算等。

限制

  • 该技能描述语义、陷阱与恢复方式;MCP JSON-Schema 才是形状的权威来源,技能中不重复 schema 内容。
  • 每条运行时行为声明都带有构建戳(as-of 头或 Observed-on 行)。
  • 按经纪商覆盖的扩展点(Q-B<n> 前缀、assets/broker_overrides.example.json)本迭代未发布,按需添加。
  • 部分怪癖状态:截至 rest-proxy 1.0.18,六个远程怪癖仍活跃(Q-R1、Q-R2、Q-R3、Q-R5、Q-R8、Q-R10);Q-R4 与 Q-R7 错误信息格式已调整;Q-R11 可能已修复但尚未移除。
  • 具体收费、价格、平台支持范围等未在资料中提供。