Claude MT5 MCP服务器Linux专用
*待完成*
Claude Desktop的本地MCP服务器，用于通过Wine与Linux上运行的MetaTrader 5终端进行交互。
该项目弥合了原生Linux Claude Desktop应用程序和仅支持Windows的MetaTrader 5终端之间的差距。它允许克劳德直接从您的交易平台访问账户信息、提取市场数据和分析指标。
______________________________________________________________________
⚠️ 安全和架构警告
这不是标准的企业级解决方案。它是一个 巧妙的专家级解决方法 这取决于复杂而脆弱的技术链：
- 葡萄酒： 我们使用Wine兼容层在Linux上运行Windows MT5终端。
- 葡萄酒Python： 我们安装了 *第二*，Windows原生Python解释器 *内部* 葡萄酒。
- GUI依赖： 此服务器 需要 MetaTrader 5桌面应用程序可以打开、运行和登录。它不是一个无头、全天候的服务器。
这种设置可能很脆弱。对Wine、MT5或Linux驱动程序进行简单的更新可能会破坏它。 始终先在模拟账户上进行测试。 使用风险自负。
______________________________________________________________________
⚙️ 运作原理
- 克劳德桌面 开始你的
run.sh脚本，已在其配置中注册。 - 这
run.sh脚本启动wine python.exe（葡萄酒中的Windows Python）。 - 这个Wine Python脚本(
mcp_server.py)启动并监听上的命令stdio. - 当Claude发送请求（例如“获取余额”）时，脚本会导入
MetaTrader5图书馆。 - 然后，它将连接到您的 *跑步*
mt5.exe应用程序，获取数据，并将其作为JSON发送回Claude。
______________________________________________________________________
🚀 安装和设置指南
这是一个完整的、循序渐进的指南，来自一个新的基于Linux Mint/Ubuntu的系统。
步骤1：安装核心Linux依赖项（Git和Wine）
首先，我们需要 git 客户端下载项目和 wine 运行Windows应用程序的兼容层。
# Update your package lists
sudo apt update
# Install git
sudo apt install git -y
# Install Wine (this is the main, stable package)
sudo apt install wine -y步骤2：获取项目代码
将此存储库克隆到您的主目录。
# Navigate to your home directory
cd ~
# Clone the project
git clone
# Enter the new project directory
cd claude-mt5-mcp步骤3：安装MetaTrader 5（通过Wine）
这使用官方的Linux安装脚本，该脚本使用Wine安装Windows版本。
# Download the official MT5 Linux installer
wget
# Make the script executable
chmod +x mt5linux.sh
# Run the installer. This will open a standard Windows-style setup wizard.
./mt5linux.sh按照屏幕上的安装程序进行操作 就像你在Windows上一样。
步骤4：安装Windows Python（通过Wine）
现在，我们必须安装一个Windows原生Python *内部* 我们的葡萄酒环境。
# Download the Windows Python 3.11 installer
wget [https://www.python.org/ftp/python/3.11.5/python-3.11.5-amd64.exe](https://www.python.org/ftp/python/3.11.5/python-3.11.5-amd64.exe)
# Run the installer using Wine
wine python-3.11.5-amd64.exe将弹出Windows安装程序。 这是最重要的一步：
- 检查 底部的盒子上写着 “将python.exe添加到PATH”.
- 点击 “立即安装”.
步骤5：安装Python依赖项（通过Wine Pip）
安装了Wine Python后，我们现在使用它 pip 安装所需的Windows库。
# 1. Update Wine-Pip to the latest version
wine python.exe -m pip install --upgrade pip
# 2. Install the MetaTrader5 library (Windows version)
wine pip install MetaTrader5
# 3. Install the jsonschema library (Windows version)
wine pip install jsonschema______________________________________________________________________
🛠️ 配置
您的代码现在已100%安装。我们只需要配置应用程序以相互通信。
第1部分：配置MetaTrader 5
- 打开 MetaTrader 5 您安装的应用程序。
- 在顶部菜单中，转到 工具 -> 选项.
- 点击 智能交易系统 选项卡。
- 检查 盒子为 “允许Algo交易”.
- 点击 好的.
第2部分：配置Claude桌面
这是最后一步。我们需要手动编辑Claude的配置文件，以告知它我们的新服务器。
1.获得项目的绝对路径
在项目文件夹中运行此命令以获取确切路径：
pwd它将输出类似以下内容： /home/user_name/claude-mt5-mcp。复制此路径。
2.编辑Claude配置文件
使用文本编辑器打开Claude配置文件。该文件位于： /home/user_name/.config/Claude/claude_desktop_config.json
在编辑之前， 您的文件可能看起来像这样（或为空）：
{
"mcpServers": {
"some-other-server": {
"command": "npx",
"args": [ ... ]
}
}
}编辑后， 添加新服务器。 不要删除现有服务器。 将您的绝对路径粘贴到 command 现场。
{
"mcpServers": {
"some-other-server": {
"command": "npx",
"args": [ ... ]
},
"mt5-local-server": {
"command": "/home/user_name/claude-mt5-mcp/run.sh",
"args": []
}
}
}保存文件。
______________________________________________________________________
⚡ 运行服务器
你准备好了！
- 完全重新启动您的Claude桌面 应用程序（退出并重新打开）。
- 确保您的MetaTrader 5 应用程序是 打开、运行和登录 到您的交易账户。
- 在克劳德，开放 设置 -> 开发者 -> 扩展.
- 你应该看看
mt5-local-server与a一起列出 “正在运行” 状态。 - 打开一个新的聊天并测试它！
示例提示：
- *“使用我的MT5工具，我的账户余额是多少？”*
- *“欧元兑美元的当前买卖价差是多少？”*
- *“获取英镑兑美元的最后10个小时柱状图。”*
- *“上半年欧元兑美元的14期SMA是多少？”*
______________________________________________________________________
🔍 故障排除
- Claude中的“服务器已断开连接”或“失败”状态：
1. MT5正在运行吗？ 这是首要原因。服务器 *不会启动* 如果它无法连接到MT5。 1. 是否勾选了“允许Algo交易”？ 1. 检查日志文件： 脚本将所有错误重定向到 mcp_server.log 在您的项目文件夹中。打开此文件以查看确切的Python错误。
- GitHub操作CI失败（红色X）：
这是 预期GitHub Actions运行器是一台干净的Linux机器。它没有Wine或Windows Python环境，因此 test_mt5_tools.py 脚本在尝试执行以下操作时失败 import MetaTrader5。这不会影响您的本地设置。