io.github.TradeSystemsNique/aidatataskrunner-mcp

Control AiDataTaskRunner Panel directly via MCP

---

Main features

Task Management

Control your backtesting queue directly from Claude:

• Add Tasks: Queue new backtests with custom symbols, dates, and timeframes
• Monitor Status: Track task progress (Processing, Queued, Pending, Ready, Failed)
• Batch Operations: Execute all pending tasks or clean completed ones
• File Management: Save/load task configurations from CSV files

Configuration Control

Manage panel settings via Claude:

• Load/Save Configurations: Save and load panel settings from text files
• Query Folders: Check data generation and task storage locations
• System Information: Access MT5 logs and system time

Natural Language Integration

Use Claude to automate your trading data pipeline:

• Query task counts and details
• Add multiple backtests in batch
• Organize and manage task configurations
• Monitor real-time execution status

Real-Time Updates

• Asynchronous operations delivered directly to chat
• Non-blocking task execution (fire-and-forget support)
• Instant status feedback from the panel

---

Repository Structure

AiDataTaskRunerMcp/
└── aidatataskrunner_mcp/                      # Python MCP server source code
    └── __init__.py
 

---

Requirements

• For repo code

• Check: dependencies.json

• For user use:

• AiDataTaskRunner panel
• McpServer requerid a EX5 Library, pucharse in: TheBotPlace - McpServerByLeo

---

Installation

cd "C:\Users\YOUR USER\AppData\Roaming\MetaQuotes\Terminal\YOUR ID\MQL5\Shared Projects"
tsndep install "https://forge.mql5.io/nique_372/AiDataTaskRunerMcp.git"

• For use tsndep command requerid tsndep pacakage (avaible in pypi).. This command automatically downloads all dependencies and installs all requirements from the repositories.

---

Quick Start (With claude ai) for final users

1. Install MCP Server

# Install from PyPI
pip install aidatataskrunner-mcp

2. Create a config json

Open Common\Files And create a file with this structure:

{
    "general_config": {
        "port": 9999,
        "host": "localhost",
        "mode": "fast_mcp"
    },
    "fast_mcp": {
        "name": "FastMcpServer"
    },
    "http": {
        "http_port": 8000,
        "name": "HTTP Server",
        "tools_namespace": "tools"
    }
}

3. Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "aidatataskrunner": {
      "command": "python",
      "args": ["-m", 
      "aidatataskrunner_mcp", 
      "--config", 
      "PATH_TO_FILE", 
      "--config_encodig", 
      "utf-8"
      ]
    }
  }
}

• PATH_TO_FILE: Path to json config file

4. Configure your MT5

Navigate to the "Tools" section >> "Options" >> "Allowed URLs for WebRequest", add a new field with the host/address you will be using (in this case "127.0.0.1"), and click Accept.

5. Connect with AiDataTaskRunner Panel

Start your AiDataTaskRunner Panel in MT5 with the AI tab enabled:

• The panel will connect to the MCP server on port 9999
• Claude will automatically detect available tools

6. Use in Claude

- Add a new EURUSD task from 2023.01.01 to 2024.01.01 on H1 timeframe, and Symbol Folder = XAUUSD, Label id = 0
- Give me the total number of tasks I have
- Clean all task
- Run all task

Claude will automatically translate this to the appropriate MCP call.

Note:

You can also use HTTP Remote with the help of "mcp-remote" (see: https://forge.mql5.io/nique_372/McpServer/wiki/Running-HTTP)

---

Available Tools

Task Management

• aidatataskrunner_add_task — Add a new backtest task
• aidatataskrunner_get_task_total — Get total task count
• aidatataskrunner_get_task_by_index — Get task details by index
• aidatataskrunner_get_task_status — Get task execution status
• aidatataskrunner_execute_all_tasks — Execute all pending tasks
• aidatataskrunner_clean_all_tasks — Clean completed tasks

File Operations

• aidatataskrunner_save_tasks_to_file — Export tasks to CSV
• aidatataskrunner_load_tasks_from_file — Import tasks from CSV
• aidatataskrunner_save_config — Save panel configuration
• aidatataskrunner_load_config — Load panel configuration

Information Queries

• aidatataskrunner_get_main_folder — Get main data folder path
• aidatataskrunner_get_task_folder — Get tasks folder path
• aidatataskrunner_is_in_commonfolder — Check if using common MT5 folder

---

License

Read Full License By downloading or using this repository, you accept the license terms.

---

Documentation

Full documentation is available in the main repository:

• AiDataTaskRunner Wiki
• MCP Integration Guide
• MCP Integration Guide with claude

---

Contact

• Platform: MQL5 Community
• Profile: https://www.mql5.com/es/users/nique_372/news

---

Copyright © 2026 Nique-Leo.