e954883189
chore: simplify docs for LLM automation, remove platform-specific install steps
...
- Rewrite README.md to focus on LLM-driven install setup
- Simplify QUICKSTART.md to minimal LLM instruction guide
- Rewrite CONFIG.md to remove platform-specific path examples
- Delete platform-specific IDE docs (CLAUDE.md, CURSOR.md, VSCODE.md, WINDSURF.md)
- Simplify REMOTE_AGENTS.md to remove Wine install details
- Clean up TROUBLESHOOTING.md to remove platform install sections
- Ignore .vscode/ and .codegraph/ directories
- Untrack server.json (should remain tracked - already restored)
2026-06-25 14:49:30 +07:00
bce0323469
docs: update README and MCP_TOOLS for deals-in-DB architecture
...
- README: update deal analytics count (19 dimensions, DB-backed)
- MCP_TOOLS: remove deals.csv/deals_json from backtest output schema
- MCP_TOOLS: add export_deals_csv tool documentation
- MCP_TOOLS: update analytics tools to show report_id/report_dir/latest pattern
- MCP_TOOLS: fix get_backtest_crash_info description
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-23 00:53:51 +07:00
436566e019
docs: add missing tools to README.md
...
- Added list_symbols to Core workflow
- Added list_jobs to Optimization section
- Added promote_to_baseline to Reports section
- Added read_set_file and write_set_file to .set files section
- Added diff_set_files to .set analysis section
- Added check_update and update to Debugging section
- Added get_backtest_history to History & Comparison section
Brings documented tools from 87 to 89 (matching actual count)
2026-04-22 08:47:37 +07:00
74c3fdb87e
docs: fix binary paths and tarball names across all documentation
...
Updated files:
- README.md: Fix tarball filename mt5-quant -> mcp-mt5-quant
- QUICKSTART.md: Fix tarball names and all binary paths
- WINDSURF.md: Fix tarball names, binary paths, and install script paths
- CURSOR.md: Fix tarball names and all binary path references
- VSCODE.md: Fix tarball names and all binary path references
All paths now correctly point to:
- Prebuilt: /path/to/mt5-quant/mcp-server/bin/mt5-quant
- Dev build: /path/to/mt5-quant/target/release/mt5-quant
2026-04-22 08:45:06 +07:00
b9729b7121
docs: fix tool count inconsistencies across documentation
...
- README: 87 → 89 tools (tagline and docs table)
- QUICKSTART.md: 43 → 89 tools
- ARCHITECTURE.md: 43 → 89 tools
Verified actual count: 89 tools via grep of definitions/mod.rs
2026-04-22 08:35:19 +07:00
e7d2ec5a47
docs: clarify optimization differences
...
Others can run optimization via terminal but lack:
- Background execution with polling
- Results parsing into structured data
- Automatic .set file generation
- Optimization history and search
2026-04-22 08:30:18 +07:00
7620cb3c04
docs: clarify comparison with other MT5 MCPs
...
- Update 'Others' column to acknowledge Windows MT5 Python package
- Clarify MQL5 compilation: others via GUI/terminal, we do headless
- Add 'Report organization' as unique MT5-Quant feature
- Emphasize focus on backtest analytics and workflow management
2026-04-22 08:27:49 +07:00
9a8594426a
docs: add crates.io metadata and cargo install instructions
...
- Add crates.io package metadata (license, keywords, categories)
- Expand 'Why Rust' section with clearer benefits
- Add cargo install option alongside binary download
- Add Acknowledgements and Disclaimer sections
2026-04-22 08:14:59 +07:00
e58316e70e
feat: add check_update and update tools with background auto-check
...
On the first tool call of each session, a background task fires once
and fetches the latest release tag from the GitHub API (5 s timeout).
The result is cached in a static OnceLock for the lifetime of the
process — no repeated network calls.
check_update: returns cached result instantly, or fetches on demand
if the background task hasn't completed yet.
update: downloads the latest tarball for the current platform, extracts
the binary, and atomically replaces the running executable via a
temp-file rename. Requires MCP reconnect to activate new version.
Platform support: macos-aarch64, macos-x86_64, linux-x86_64.
Unsupported platforms return a build-from-source hint.
Tool count: 87 → 89. README and MCP_TOOLS.md updated.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-22 07:34:25 +07:00
ac5ec453d3
docs: clean up public repo — remove IDE files, fix stale refs
...
- Untrack .claude/commands/ and .windsurf/workflows/ (personal IDE config)
- Fix .gitignore: scope /CLAUDE.md to root only, add .claude/, remove
incorrect .github/workflows/ exclusion (CI needs these tracked)
- Rename docs/ANTIGRAVITY.md → docs/CLAUDE.md (Claude Desktop setup;
"Antigravity" was an internal codename, confusing to public users)
- Fix stale repo name: masdevid/mt5-mcp → masdevid/mt5-quant in
README.md, docs/CLAUDE.md, CURSOR.md, QUICKSTART.md, VSCODE.md, WINDSURF.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-04-22 07:20:20 +07:00
0bc410f613
feat: add Wine/MT5 debugging tools and update release workflow
...
- Add 9 debugging/diagnostics tools for Wine/MT5 crash investigation
- Update server.json with v1.30.0 and MCP package config
- Update README.md with 85 tools count and debugging section
- Update docs/MCP_TOOLS.md documentation
- Enhance release workflow with MCP packaging job
- Clean up mcp-package directory (now built in CI)
2026-04-22 04:41:41 +07:00
6ce8808948
v1.30.0: Add 10 Wine/MT5 debugging tools
...
New debugging/diagnostics tools for crash investigation:
- diagnose_wine: Check Wine installation and prefix health
- get_mt5_logs: Get terminal/tester/metaeditor logs
- search_mt5_errors: Search logs for error patterns
- check_mt5_process: Check MT5 process status
- kill_mt5_process: Kill stuck MT5 processes
- check_system_resources: Check disk/memory/CPU
- validate_mt5_config: Validate MT5 configuration
- get_wine_prefix_info: Wine prefix details
- get_backtest_crash_info: Investigate backtest failures
Total tools: 85
Documentation updated in README.md and MCP_TOOLS.md
2026-04-20 02:25:07 +07:00
896aa6111e
feat: auto-detect and register MCP on multiple platforms
...
- Add multi-platform MCP detection (Claude, Windsurf, Cursor, VS Code)
- Auto-unregister previous installations before reinstall
- Create platform-specific docs (CURSOR.md, VSCODE.md, ANTIGRAVITY.md)
- Update Windsurf config to use correct JSON path (~/.codeium/windsurf/mcp_config.json)
- Fix VS Code config format (uses 'servers' not 'mcpServers')
- Remove MT5_MCP_HOME requirement from MCP configs (binary auto-detects)
- Slim down README installation section with platform table
- Update QUICKSTART.md with all platform instructions
2026-04-20 00:40:41 +07:00
42318b040a
docs: update README with Claude Code and Windsurf MCP installation instructions
...
- Separate download/setup and MCP registration steps
- Add detailed Claude Code registration with verification
- Add Windsurf config.yaml examples (manual and automated)
- Add absolute path requirement warning note
2026-04-19 09:45:47 +07:00
cbed3d15af
docs: update README and MCP_TOOLS.md for 57 tools
...
README.md:
- Update tool count: 43 → 57
- Add Pre-flight & Validation section with get_active_account, check_symbol_data_status, check_mt5_status, validate_ea_syntax
- Add Project Management section with init_project, create_set_template, export_report
- Add History & Comparison section with get_backtest_history, compare_backtests
- Add Search & Discovery section with search_experts, search_indicators, search_scripts, copy_indicator_to_project, copy_script_to_project
MCP_TOOLS.md:
- Update documentation status: 31 → 49 of 57 tools documented
- Add 8 new utility tool schemas:
- get_active_account
- check_symbol_data_status
- check_mt5_status
- get_backtest_history
- compare_backtests
- init_project
- validate_ea_syntax
- create_set_template
- export_report
- Add workflow examples for pre-flight validation, project management, and history comparison
2026-04-19 08:28:07 +07:00
61c5fd4dce
docs: Move WINDSURF_SETUP.md to docs/WINDSURF.md
...
Consistent documentation structure - all docs now in docs/ directory.
- Moved: WINDSURF_SETUP.md → docs/WINDSURF.md
- Updated README.md link
2026-04-19 03:35:05 +07:00
1461d9cd37
docs: Reorganize documentation structure
...
**README.md** - Slimmed from 548 → 156 lines
- Removed duplicated content now in separate docs
- Links to new focused documentation files
- Quick install + quick start only
**New docs created:**
- docs/QUICKSTART.md - Complete setup guide (macOS/Linux)
- docs/CONFIG.md - Configuration reference with examples
- docs/TROUBLESHOOTING.md - Common issues and solutions
**Existing docs retained:**
- docs/MCP_TOOLS.md - Tool specifications (31/43 documented)
- docs/ARCHITECTURE.md - Design and internals
- docs/REMOTE_AGENTS.md - Linux optimization agents
**Documentation structure:**
2026-04-19 03:33:54 +07:00
3f827fd168
docs: Update documentation for modular structure and 43 tools
...
**README.md:**
- Updated tool count: 28 → 43
- Added granular analytics tools section (8 tools)
- Added list_indicators, list_scripts, healthcheck to Core workflow
- Added get_latest_report, search_reports to Reports section
**docs/ARCHITECTURE.md:**
- Updated file structure from monolithic (definitions.rs, handlers.rs)
to modular (definitions/, handlers/ with 9 domain submodules)
- Updated tool count: 27 → 43
**WINDSURF_SETUP.md:**
- Cleaned up mixed Indonesian/English text
- 'Deployment ke' → 'Deployment to', 'di' → 'at', 'atau' → 'or'
**CLAUDE.md:** (gitignored template, updated but not committed)
- Updated file structure documentation
- Updated tool count: 27 → 43
- Updated tool development workflow for modular architecture
2026-04-19 03:28:32 +07:00
a3b046c68f
feat: complete Rust migration with modular architecture
...
Major changes:
- Migrate Python/shell scripts to Rust modules:
- analytics/extract.py → src/analytics/extract.rs (ReportExtractor)
- analytics/analyze.py → src/analytics/analyze.rs (DealAnalyzer)
- scripts/mqlcompile.sh → src/compile/mql_compiler.rs (MqlCompiler)
- scripts/backtest_pipeline.sh → src/pipeline/backtest.rs (BacktestPipeline)
- New modular structure:
- src/models/ - Config, Deal, Metrics, Report structs
- src/analytics/ - Report parsing and deal analysis
- src/compile/ - MQL5 compilation via Wine
- src/pipeline/ - 5-stage backtest orchestration
- src/tools/ - 27 MCP tool definitions and handlers
- Remove PyInstaller setup (now pure Rust)
- Remove migrated shell scripts (backtest_pipeline.sh, mqlcompile.sh)
- Add GitHub Actions CI/CD for macOS & Linux releases
- Update all documentation for Rust architecture
Binary size: 4.3MB (no Python dependencies)
Tools: 27 MCP tools fully functional
2026-04-18 15:07:08 +07:00
3f763827f4
feat: MT5-Quant MCP server for backtesting and optimization
...
MCP server exposing MetaTrader 5 strategy development tools to AI
assistants (Claude, Cursor, etc.) on macOS (CrossOver) and Linux (Wine).
Tools:
- run_backtest: full pipeline — compile EA, clean cache, backtest,
parse HTML/XML report, analyze deals → metrics.json + analysis.json
- run_optimization: background genetic optimization with nohup/disown,
UTF-16LE .set file handling, OptMode reset
- compile_ea: MQL5 compilation via MetaEditor with auto-detected
include/ directory sync
- get_backtest_status / get_optimization_status: job polling
- verify_environment: Wine/MT5 path validation
Analytics:
- extract.py: MT5 HTML and SpreadsheetML XML report parser
- analyze.py: deal-level analysis (drawdown events, grid depth,
loss sequences, monthly P&L) → analysis.json
- optimize_parser.py: optimization result parser with convergence analysis
Platform support:
- macOS CrossOver (GUI mode, no Xvfb needed)
- Linux Wine + Xvfb (headless, CI/CD compatible)
- Auto-detection of Wine executable and MT5 terminal paths
2026-04-18 11:41:41 +07:00
Devid HW