Gold Shield Ea

GoldShield EA

Safety-First XAUUSD Expert Advisor with AI-Ready Data Pipeline

______________________________________________________________________

EA交易。数据库会记住。你带来了自己的AI。

______________________________________________________________________

特性

交易引擎 --EMA交叉+RSI过滤器，基于ATR的SL/TP/尾随，每日损失限额，点差保护，冷却，基于风险的规模

数据管道 --PostgreSQL+TimescaleDB+pgvector，8个时间帧（M1--W1），交易日志，向量嵌入

仪表板 --带参数编辑器的流线型UI、烛台图、损益曲线、ML训练、带恢复的快照

AI和ML --MCP服务器（8个工具），自带LLM、sklearn（5个模型）、R（ARIMA/ETS/RF）、CSV导出、pgvector相似性搜索

______________________________________________________________________

快速开始

git clone https://github.com/Supawitk/GoldShield-EA.git && cd GoldShield-EA
cp .env.example .env              # add your Twelve Data API key (free)
docker compose up -d              # PostgreSQL + TimescaleDB + pgvector

pip install -r scripts/requirements.txt
python scripts/collect_data.py                    # fetch H1 candles
python scripts/collect_data.py --all-timeframes   # all 8 timeframes

pip install -r dashboard/requirements.txt
streamlit run dashboard/app.py                    # launch UI

python scripts/trade_api.py                       # start trade logging API
python scripts/generate_embeddings.py             # generate pgvector embeddings

包含所有标志和选项的完整命令参考： docs/COMMANDS.md

______________________________________________________________________

MCP服务器

pip install -r mcp-server/requirements.txt

添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "goldshield": {
      "command": "python",
      "args": ["mcp-server/server.py"],
      "cwd": "/absolute/path/to/GoldShield-EA"
    }
  }
}

8种可用工具： get_recent_trades get_trade_stats get_candles compare_parameter_sets suggest_parameters find_similar_conditions export_csv run_sql

带上你自己的法学硕士 通过Dashboard AI页面-支持Claude、OpenAI、Gemini、Ollama或任何与OpenAI兼容的端点。未存储密钥。

看 docs/COMMANDS.md 用于完整的工具参数和API端点文档。

______________________________________________________________________

项目结构

GoldShield-EA/
├── GoldShield_EA.mq5            # MT5 EA (with WebRequest trade logging)
├── docker-compose.yml            # One-command DB setup
├── db/
│   ├── connection.py             # Shared DB utilities (used by all scripts)
│   └── migrations/               # SQL schema (4 files)
├── scripts/
│   ├── collect_data.py           # Multi-TF candle fetcher
│   ├── trade_api.py              # HTTP trade logging server
│   ├── generate_embeddings.py    # pgvector embedding generator
│   ├── export_csv.py             # CSV export
│   └── backtest_logger.py        # MT5 report parser
├── dashboard/app.py              # Streamlit UI (6 pages)
├── ml/                           # sklearn + R models
├── mcp-server/server.py          # MCP server (8 tools)
├── docs/COMMANDS.md              # Full CLI & API reference
├── snapshots/                    # Point-in-time state captures
└── exports/                      # CSV output

______________________________________________________________________

更新日志

v1.1.0版本

• 共享 db/connection.py --带有上下文管理器的单个DB实用程序（重复6次）
• 交易日志HTTP API+MQL5 WebRequest集成（EA自动加载到PostgreSQL）
• 用于pgvector相似性搜索的嵌入生成器
• 仪表板中的快照还原
• 完整命令参考已移动到 docs/COMMANDS.md

v1.1

• 仪表板用户界面（6页），多时间段集合，机器学习模型（sklearn+R）
• AI助手，自带密钥LLM，MCP服务器，CSV导出+矢量搜索

v1.0

• 初始版本：XAUUSD H1的GoldShield EA
• 通过Docker Compose实现PostgreSQL+TimescaleDB+pgvector

______________________________________________________________________

免责声明

对于 仅用于教育和研究目的交易涉及重大风险。始终使用 模拟帐户 第一。

______________________________________________________________________

Built with MQL5 + PostgreSQL + TimescaleDB + pgvector + MCP + Streamlit + scikit-learn + R