MT5远程监控服务

一个通过SSH连接远程Windows VPS上的MetaTrader 5账户进行只读监控的MCP服务器,不执行任何交易操作,仅为AI代理提供交易数据查询服务。

  • by Marco7734
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Marco7734/mt5-remote-reader-mcp

使用说明

mt5远程读卡器mcp

只读 MCP服务器通过SSH监控远程Windows VPS上的MetaTrader 5帐户。
从不执行交易操作,只进行纯粹的监控。


它做什么

mt5-remote-reader-mcp 允许任何兼容MCP的AI代理(Claude、Cursor、Windsurf等)连接到运行MetaTrader 5的Windows VPS,并回答有关您的交易账户的问题——所有这些都是通过SSH完成的,没有永久连接,也没有意外交易的风险。

示例提示:

“使用mt5远程阅读器mcp,使用密码XXXX连接到VPS 107.x.x.x,并告诉我当前有哪些职位空缺”

AI将:

  1. 通过SSH连接到您的VPS
  2. 查询MetaTrader 5
  3. 以自然语言返回数据

安装

pip install mt5-remote-reader-mcp

快速开始

1.设置您的VPS(仅限一次)

在您的Mac/Linux上,运行:

python setup_vps.py YOUR_VPS_IP YOUR_VPS_PASSWORD

这将安装Python、所需库和 mt5_tool.py 在VPS上自动。

2.配置您的MCP客户端

添加到MCP客户端配置中(例如。 claude_desktop_config.json):

{
  "mcpServers": {
    "mt5-remote-reader": {
      "command": "mt5-remote-reader-mcp"
    }
  }
}

3.与你的AI对话

"Connect to my VPS at 1.2.3.4 with password XXXX and show me open positions"
"What trades did mt5_5 close in the last 7 days?"
"Is the expert advisor on axi_mt5_5_terminal logging any errors?"

可用工具

工具 说明 参数
list_terminals 列出VPS上所有活动的MT5终端 ip, password
get_open_positions 获取当前空缺职位 ip, password, terminal
get_trade_history 获取已平仓交易历史记录 ip, password, terminal, days (默认值:30)
get_expert_log 获取智能交易系统日志条目 ip, password, terminal, lines (默认值:100)
get_symbols 列出所有可用的交易品种 ip, password, terminal
get_symbol_info 获取特定符号的详细信息 ip, password, terminal, symbol

推荐流量

始终从以下内容开始 list_terminals 要发现哪些终端可用,请使用短终端名称(例如。 mt5_5)对于所有后续通话。


环境变量(可选)

变量 默认值 描述
MT5_TOOL_PATH C:\Users\Administrator\Desktop\mt5_tool.py VPS上mt5_tool.py的路径
VPS_USER Administrator VPS的SSH用户名

自定义路径示例:

MT5_TOOL_PATH="C:\trade_monitor\mt5_tool.py" mt5-remote-reader-mcp

VPS要求

  • Windows Server 2012 R2或更高版本
  • MetaTrader 5已安装并登录
  • Python 3.8+已安装并在PATH中
  • OpenSSH服务器通过密码身份验证处于活动状态
  • mt5_tool.py 部署在VPS上(由 setup_vps.py)

建筑

AI Agent
    ↓
mt5-remote-reader-mcp  (MCP stdio, runs on your local machine)
    ↓
SSH + password  (paramiko, no pre-configured keys needed)
    ↓
Windows VPS
    ↓
mt5_tool.py + MetaTrader5 Python library
    ↓
JSON  →  natural language response

为什么选择stdio?
不需要后台进程。MCP服务器按需启动,完成请求,然后退出。SSH是快速且无状态的——在调用之间没有什么可以保持活动的。

为什么是帕拉米科?
纯Python SSH库——适用于任何Mac、Linux或Windows,无需系统级SSH依赖。


安全

  • 按设计只读 --从未执行过任何交易操作
  • 每次调用都会传递凭据,从不存储到磁盘
  • SSH连接为每个请求打开和关闭
  • 在标准SSH端口22上工作——不需要自定义防火墙规则

故障排除

“身份验证失败”
→ 检查IP和密码。确保OpenSSH在VPS上运行(net start sshd).

“VPS无输出”
→ 确保 mt5_tool.py 位于预期的路径上。跑 setup_vps.py 再次重新部署它。

“未找到MT5终端”
→ 在查询之前,请确保MetaTrader 5已打开并登录到VPS。

“未找到模块MetaTrader5”
→ Run setup_vps.py 再次,它将重新安装所需的Python库。


许可证

麻省理工学院——见 许可证


相关项目