使用说明

项目简介

MetaTrader MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在使 AI LLMs 能够通过 MetaTrader 5 平台进行交易。它作为 LLM 和 MetaTrader 5 之间的桥梁，提供账户信息查询和交易工具调用等功能，使得 LLM 能够理解和操作金融市场数据。

主要功能点

连接 MetaTrader 5 交易平台: 能够安全稳定地连接到 MetaTrader 5 客户端，是 LLM 访问金融市场数据的入口。
MCP 协议支持: 遵循 Model Context Protocol 标准，确保与各种 MCP 客户端的兼容性和互操作性。
账户信息查询: 提供工具查询 MetaTrader 5 交易账户的实时信息，如账户余额、净值、保证金等，帮助 LLM 掌握账户状态。
交易工具扩展性: 架构设计允许注册和扩展更多的交易工具，例如执行交易、管理订单等（当前版本可能只实现了部分工具或示例工具）。
开发文档: 提供开发者文档，方便二次开发和功能扩展。

安装步骤

前提条件: 确保已安装 Python 3.8 或更高版本，并安装了 'uv' 包管理器 (可以使用 'pip install uv' 安装)。
获取代码: 克隆 GitHub 仓库到本地：'git clone https://github.com/ariadng/metatrader-mcp-server.git'
进入目录: 进入项目根目录：'cd metatrader-mcp-server'
创建虚拟环境: 创建并激活 Python 虚拟环境，隔离项目依赖：
- 'uv venv'
- 'source .venv/bin/activate' (Linux 或 macOS)
- '.venv\Scripts\Activate.ps1' (Windows PowerShell)
安装依赖: 安装项目所需的 Python 包： 'uv pip install -e .'

服务器配置

MCP 服务器启动命令配置 (JSON 格式，用于 MCP 客户端配置连接参数):

{
  "server name": "MetaTrader MCP Server",
  "command": "python",
  "args": ["-m", "src.mcp_server.main"]
}

'server name': 服务器的自定义名称，用于在 MCP 客户端中标识连接。
'command': 运行服务器的命令，通常为 'python'。
'args': 传递给 'python' 命令的参数，'-m src.mcp_server.main' 表示以模块方式运行 'src/mcp_server/main.py' 文件，这是服务器的入口点。

注意: MCP 客户端需要配置以上 JSON 信息才能连接到 MetaTrader MCP Server。无需修改 JSON 代码本身，只需在 MCP 客户端软件中填入相应的配置项。

基本使用方法

配置 MetaTrader 5: 确保已安装 MetaTrader 5 客户端，并拥有有效的交易账户（可以是模拟账户或真实账户）。

配置环境变量: 在项目根目录下创建 '.env' 文件，并填入您的 MetaTrader 5 账户登录信息，例如：

LOGIN=您的MT5登录ID
PASSWORD=您的MT5登录密码
SERVER=您的MT5服务器地址

请替换 '您的MT5登录ID'、'您的MT5登录密码' 和 '您的MT5服务器地址' 为您的实际账户信息。

启动 MCP 服务器: 在激活的虚拟环境中，运行服务器启动命令 (即上面服务器配置 JSON 中的 'command' 和 'args')，例如在终端中执行： 'python -m src.mcp_server.main'。
连接 MCP 客户端: 使用 MCP 客户端软件，根据上述 “服务器配置” 中的 JSON 信息配置连接，连接到正在运行的 MetaTrader MCP Server。
调用工具: 在 MCP 客户端中，可以调用服务器提供的工具，例如 'get_account_info' 工具，来获取 MetaTrader 5 账户信息。具体工具调用方法请参考 MCP 客户端软件的使用说明。

提示: 首次使用请先使用模拟账户进行测试，确保配置正确和功能符合预期。并仔细阅读代码和文档，了解更多高级功能和配置选项。

关键词