Fullmt5mcpbyleo

用于 MetaTrader 5 交易与数据操作的通用 MCP 服务

---

概述

FullMt5McpByLeo 是一个功能完整、可用于生产环境的 MCP 服务，可让 Claude 和其他 AI 助手直接控制 MetaTrader 5。通过自然语言执行交易、获取市场数据、管理图表、分析交易历史并自动化 MT5 操作。

---

主要功能（常规）

• 执行速度快；MCP 服务使用 C++ 和 simdjson 编写，MQL5 使用 JsonParserByLeo（快速 MQL5 JsonParser），代码经过超优化，可实现最高速度。
  平均响应时间约为 10ms（从 Claude 调用函数到收到响应；请注意，这可能取决于请求大小……平均约为 10ms）。
• 与其他用于 MT5 的 MCP 不同，此 MCP 分为两部分，一部分使用 MQL5，另一部分使用 C++，因此可以访问完整的 MQL5 API，不受 Python 的 mt5 包限制；后者缺少图表处理等功能。

主要功能（MCP 函数）

交易操作

执行和管理交易持仓与订单：

• 开仓： 执行市价交易（买入/卖出），支持立即执行或挂单
• 持仓管理： 修改止损/止盈，平仓（全部或部分）
• 订单管理： 创建、修改和取消限价/止损挂单
• 交易历史： 查询已完成的交易，并分析盈亏

市场数据与交易品种

访问实时和历史数据：

• OHLC 数据： 获取 K 线数据（开盘价、最高价、最低价、收盘价、成交量、点差等）
• Tick 数据： 获取 Tick 数据（最新价、卖价、买价、标志等）
• 交易品种信息： 获取交易品种属性（小数位数、点差、隔夜利息、交易量等；完整的 SYMBOL_INFO_*）
• 市场报价： 管理交易品种的选择与可用性

指标

• 指标管理器： 获取参数、添加指标（全部、自定义、MA 等）、移除指标、获取缓冲区等

图形对象

创建和修改图表可视化内容：

• 绘制对象： 创建趋势线、矩形、文本标签和箭头
• 对象属性： 修改颜色、样式、价格、文本及完整的 ENUM_OBJECT_PROPERTY_*
• 图表注释： 向图表添加可视标记和指标

图表管理

控制图表窗口和重绘操作：

• 图表操作： 打开、关闭并列出活动图表
• 图表属性： 读取图表尺寸、颜色和价格范围
• 视觉更新： 强制重绘图表以实现实时更新
• 指标： 添加\删除\获取名称\获取总数，适用于任意图表\子窗口中的指标
• 导航： 浏览图表

代码与终端

编译并执行智能交易系统（EA）：

• 编译： 将 MQL5 源代码编译为 EX5 字节码
• 回测与优化： 使用多种 tick 建模方式运行历史测试\杠杆\优化标准\优化模式\前向\可视化模式等 并获取完整报告、交易记录、余额\净值曲线。
• EA 执行： 实时运行智能交易系统
• 日志记录： 获取 EA 日志，用于调试和监控
• 终端和账户： 获取终端和账户信息_*（整数、字符串、双精度浮点数）

注意：Python 版本的包 mt5_mcp_by_leo 已弃用。现在改用 C++ exe 服务。 注意：与其他使用 .ini 文件启动回测的 MCP 不同，此 MCP 无需使用 .ini 文件，因为它通过同一个 EA 控制整个 MT5 测试器，无需 .ini 文件，也不会浪费终端。此外，代码编译更加完善，因为 AI 可以选择是否优化代码、指令等。

---

仓库结构

FullMt5McpByLeo/
├── Src/                              # MQL5 Backend Functions
│    ....
├── mt5_mcp_by_leo/                   # Json tools definition
│    ....

---

⚠️ 许可证激活（必需）

如果没有来自 TheBotPlace 的有效许可证，你的 MCP 服务将无法运行。

1. 在此处购买 McpServerByLeo：https://www.thebotplace.com/bot/mcpserverbyleo
2. 从你的 TheBotPlace 账户 - 你的用户 ID 获取你的 TBP ID
3. 将其添加到 claude_desktop_config.json 的 args 数组中，或添加到 AI 平台使用的 JSON 中（请参阅下方的快速入门/第 4 步）

---

要求（安装前）

• 通用（适用于所有人）

• 来自 releases 的 EXE（McpServer.exe）

• 用于仓库代码（开发者）

• 查看：dependencies.json

• 用户使用：

• 来自 releases 的 EX5（Runner 和 Mt5Mcp）。

---

仓库代码安装

cd "C:\Users\YOUR USER\AppData\Roaming\MetaQuotes\Terminal\YOUR ID\MQL5\Shared Projects"
tsndep install "https://forge.mql5.io/nique_372/FullMt5McpByLeo.git"

• 使用 tsndep 命令需要 tsndep pacakage（可在 pypi 获取）。此命令会自动下载所有依赖项，并安装仓库中的所有要求。
• 如果系统的任何部分是私有的，操作就会失败……请联系我，我可以为你提供访问权限（如果它是产品，你可以购买；如果你有任何问题，请随时联系我）。

---

快速入门（面向最终用户）

1. 下载

从仓库的 releases 下载最新的 .exe 和 .ex5 文件。 将 .ex5 文件放入 MT5 终端的 Experts\ 文件夹，并将 .exe 文件放在易于访问的文件夹中（例如，MT5 终端的 Common\Files\ 文件夹）。

2. 下载 tools.json

下载 tools.json 文件，并将其放入终端的 Common\Files\ 文件夹。

3. 创建配置 JSON

打开 Common\Files 并创建一个具有以下结构的 JSON 文件：

{
  "general": {
    "type_reg": "stdio_stdin",
    "json_tools_fpath": "JSON_TOOL_PATH"
  },
  "mt5_conn": {
    "host": "127.0.0.1",
    "port": 9999
  },
  "http_lib": {
    "name": "McpMt5Server",
    "version": "1.0.0",
    "host": "127.0.0.1",
    "port": 8080,
    "endpoint": "/"
  },
  "stdio_stdin": {
    "name": "MT5 MCP Server",
    "version": "1.0.0"
  }
}

完整模板见 Templates/config.json

• JSON_TOOL_PATH：工具配置 JSON 的路径（你可以从 mt5_mcp_by_leo 文件夹下载 JSON，例如将其放入 documents 文件夹，然后在此处填写该文件的路径……）或者，如果你已克隆仓库，可以使用 tools.json 的路径

4. 在 Claude Desktop 中配置

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "mt5_mcp_by_leo": {
      "command": "PATH_TO_EXE",
      "args": ["PATH_TO_FILE", "YOUR_TBP_ID", "YOUR_MT5_ACCOUNT_LOGIN_ID" 
      ]
    }
  }
}

完整模板见 Templates/claude_desktop_config.json

• PATH_TO_EXE：McpServer.exe 文件的路径
• PATH_TO_FILE：JSON 配置文件的路径
• YOUR_TBP_ID：你的 The Bot Place 用户 ID
• YOUR_MT5_ACCOUNT_LOGIN_ID：Mt5Mcp EA 正在运行的 MT5 账户的 ACCOUNT_LOGGIN

5. 配置 MetaTrader 5

在 MT5 中：工具 → 选项 → 允许的 WebRequest URL

• 添加 127.0.0.1 或你配置的主机。
• 点击 接受
• 启用自动交易和 DLL 导入

6. 打开 claude desktop

打开 Claude Desktop。此时，CMcpServer.exe 会在后台运行，直到它与 EA Mt5Mcp.ex5 建立连接。

7. 在 MT5 中附加 EA

1. Run Runner.ex5 in any chart.. (dowland from releases)
2. Drag Mt5Mcp.ex5 onto your chart (any) and cofigure it, The parameters of the EA, such as port/host, must match the JSON of Claude Desktop

8. 在 Claude 中使用

Open a 0.01 lot BUY on EURUSD with SL at 1.0800 and TP at 1.0900

注意：

您也可以使用 HTTP Remote（McpServer.exe 支持通过 httplib 库和 mcp-remote npm 包使用 HTTP）（参见：https://forge.mql5.io/nique_372/McpServer/wiki/Running-HTTP）

---

许可证

阅读完整许可证

下载或使用此代码仓库即表示您接受许可证条款。

---

文档

• Wiki：https://forge.mql5.io/nique_372/FullMt5McpByLeo/wiki
• MCP 测试（完整测试视频见 YouTube）：

• https://www.youtube.com/watch?v=kco7aCOs-bM
• https://www.youtube.com/watch?v=xCscKpoCi3Y

---

联系方式

• 平台： MQL5 社区
• 个人资料： https://www.mql5.com/es/users/nique_372/news

---

版权所有 © 2026 Niquel Mendoza (nique_372)。
TSN Trading Systems 生态系统。