convez.ai
MCP ServerFinanceiroAvançado
YugenLabsTI

Yugen MT5 MCP

YugenLabsTI/yugen-mt5-mcp

Gateway seguro para IA operar MetaTrader 5 com auditoria completa

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP seguro e auditável para MetaTrader 5, fornecendo acesso controlado a dados de mercado, estado da conta e execução de trades através de controles de risco (listas de símbolos permitidos, limites de volume e trilha de auditoria). Pronto para deployment em VPS com suporte a múltiplos métodos de conexão (STDIO, LAN remoto, TLS).

Instalação

$npx convez-ai YugenLabsTI/yugen-mt5-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 5 meses
Versão
v1.0.3
Issues abertas
0
Contribuidores
2

Casos de uso

  • Automação de análise técnica e execução de ordens com IA
  • Monitoramento de contas e posições via agentes inteligentes
  • Backtesting e paper trading controlado através de Claude/Cursor

Veredito

Solução robusta para quem precisa integrar IA ao trading algorítmico, com segurança em primeiro plano (auditoria, limites de risco, validação de símbolos). Requer conhecimento técnico de MT5 e conforto com variáveis de ambiente.

README

A tradução para o português deste README ainda está na fila.

yugen-mt5-mcp

🌐 Language: English | Español

📚 New to the project? Start with the documentation index — it explains the recommended reading order. TIP: toda la documentación también está disponible en español en docs/es/.

Secure, auditable MCP server for MetaTrader 5 — gives AI clients controlled access to market data, account state, and trade execution through a hardened gate with symbol allowlists, volume limits, and an append-only audit trail.

Quick Start (for users)

Prerequisites

  • Windows with MetaTrader 5 installed and logged into a demo account
  • uv installed

Run without installing

uvx yugen-mt5-mcp

Install persistently

uv tool install yugen-mt5-mcp
yugen-mt5-mcp

Validate your setup

yugen-mt5-mcp doctor

This runs all readiness checks (config, MT5 connection, audit path, transport) without starting the server.


Client Configuration

For the complete connection guide covering all 4 methods (STDIO, LAN remote, VPS/TLS), see docs/connection-methods.md.

Claude Desktop

Add the following to your Claude Desktop config file.

  • Windows: C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "yugen-mt5": {
      "command": "uvx",
      "args": ["yugen-mt5-mcp"],
      "env": {
        "YUGEN_MT5_ALLOWED_SYMBOLS": "EURUSD,XAUUSD",
        "YUGEN_MT5_ALLOW_LIVE_TRADING": "false",
        "YUGEN_MT5_ALLOW_REAL_ACCOUNTS": "false",
        "YUGEN_MT5_MAX_ORDER_VOLUME": "1.0",
        "YUGEN_MT5_MAX_SYMBOL_EXPOSURE": "1.0",
        "YUGEN_MT5_AUDIT_PATH": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Yugen\\mt5-mcp\\audit.sqlite3"
      }
    }
  }
}

You can also generate this block automatically:

yugen-mt5-mcp config claude

Cursor

Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "yugen-mt5": {
      "command": "uvx",
      "args": ["yugen-mt5-mcp"],
      "env": {
        "YUGEN_MT5_ALLOWED_SYMBOLS": "EURUSD,XAUUSD",
        "YUGEN_MT5_ALLOW_LIVE_TRADING": "false",
        "YUGEN_MT5_ALLOW_REAL_ACCOUNTS": "false",
        "YUGEN_MT5_MAX_ORDER_VOLUME": "1.0",
        "YUGEN_MT5_MAX_SYMBOL_EXPOSURE": "1.0"
      }
    }
  }
}
yugen-mt5-mcp config cursor

OpenCode

Add the following to ~/.config/opencode/config.json:

{
  "mcp": {
    "yugen-mt5": {
      "type": "local",
      "command": ["uvx", "yugen-mt5-mcp"],
      "environment": {
        "YUGEN_MT5_ALLOWED_SYMBOLS": "EURUSD,XAUUSD",
        "YUGEN_MT5_ALLOW_LIVE_TRADING": "false",
        "YUGEN_MT5_ALLOW_REAL_ACCOUNTS": "false",
        "YUGEN_MT5_MAX_ORDER_VOLUME": "1.0",
        "YUGEN_MT5_MAX_SYMBOL_EXPOSURE": "1.0"
      },
      "enabled": true
    }
  }
}
yugen-mt5-mcp config opencode

Configuration (Environment Variables)

All configuration is via YUGEN_MT5_* environment variables. You can generate an env block interactively:

yugen-mt5-mcp init
VariableRequiredDefaultDescription
YUGEN_MT5_ALLOWED_SYMBOLSYes—Comma-separated symbol allowlist, or * for all. Wildcard prints a startup warning but does not relax any trading gate.
YUGEN_MT5_ALLOW_LIVE_TRADINGNofalseSet true to enable order execution. When false the server is read-only.
YUGEN_MT5_ALLOW_REAL_ACCOUNTSNofalseSet true to permit real (non-demo) account operations. Demo accounts do not need this.
YUGEN_MT5_MAX_ORDER_VOLUMENo1.0Max lot volume per single exposure-creating order. Does not apply to closing or modifying. Set unlimited to disable (startup warning).
YUGEN_MT5_MAX_SYMBOL_EXPOSURENo1.0Max cumulative open volume per symbol. Checked only on open. Set unlimited to disable (startup warning).
YUGEN_MT5_AUDIT_PATHNovar/audit.sqlite3Path to the SQLite audit database. Use an absolute path with desktop clients.
YUGEN_MT5_REAL_ACCOUNT_CONSENTNo—Explicit consent token for real-account operations. Resets on every restart.
YUGEN_MT5_REMOTE_ENABLEDNofalseSet true to start the HTTP remote transport. Requires [remote] extra.
YUGEN_MT5_REMOTE_HOSTNo127.0.0.1Bind host for remote transport. Use 0.0.0.0 for LAN/VPS (requires TLS termination).
YUGEN_MT5_REMOTE_PORTNo8765Port for remote transport.
YUGEN_MT5_REMOTE_BEARER_TOKENNo—Bearer token for remote transport auth. Required when YUGEN_MT5_REMOTE_ENABLED=true.

Trading safety model

ControlBehavior
Real-account acknowledgementSession-scoped. Clears on every server restart.
Allowed symbols / account modesEnforced before MT5 calls.
Volume / exposure limitsApplied to opening orders only. Closing and modifying are never capped.
Audit trailSQLite append-only log with token and secret redaction.

Remote Transport (WSL / Mac to Windows MT5)

When your AI client runs in WSL, macOS, or a VPS and MetaTrader 5 is on a Windows host, use the HTTP remote transport:

# On the Windows host:
$env:YUGEN_MT5_REMOTE_ENABLED="true"
$env:YUGEN_MT5_REMOTE_BEARER_TOKEN="your-secret-token"
yugen-mt5-mcp run --transport remote

# Generate a client config block pointing at the Windows host:
yugen-mt5-mcp config remote --host 192.168.1.100 --port 8765 --token your-secret-token

Install the remote extra first:

uv tool install "yugen-mt5-mcp[remote]"

See docs/remote-transport.md for the full deployment guide, security model, and TLS setup. For the step-by-step VPS (EC2 + Caddy/TLS) walkthrough, see docs/connection-methods.md — Method 4.


For Contributors

Clone and install in editable mode

git clone https://github.com/YugenLabsTI/yugen-mt5-mcp.git
cd yugen-mt5-mcp
python -m pip install -e ".[dev]"

Run the test suite

pytest

MT5-dependent tests are automatically skipped on non-Windows platforms.

Run linting and type checks

ruff check src tests
mypy

Start the server locally

$env:YUGEN_MT5_ALLOWED_SYMBOLS="EURUSD,XAUUSD"
yugen-mt5-mcp run

For all CLI options see docs/cli.md. For installation variants see docs/install.md.


License

Apache-2.0 — see LICENSE.md. Copyright Yugen Labs S.A.S.

Ver o original no GitHub

Bom para

Relacionados