Metadata-Version: 2.4
Name: aidatataskrunner-mcp
Version: 1.0.3
Summary: MCP server for AiDataTaskRunner Panel (MT5) - Control AiDataTaskRuner Panel for data generation and ML model training via MCP
Project-URL: Repository, https://forge.mql5.io/nique_372/AiDataTaskRunerMcp
Project-URL: Documentation, https://forge.mql5.io/nique_372/AiDataTaskRunerMcp
Project-URL: Issues, https://forge.mql5.io/nique_372/AiDataTaskRunerMcp/issues
Author-email: Nique Mendoza <tradesystemsnique@gmail.com>, Leo <leo@example.com>
License: Copyright (c) 2026 Niquel and Leo.  
        
        This repository is governed by the Niquel & Leo NL-ND License (No LLM - No Distribution).  
        Full terms and conditions are available at:  
        https://forge.mql5.io/nique_372/TSNReposIndex/src/branch/main/Licenses/LICENSE-NL-ND.md
        
        By accessing, cloning, forking, or otherwise using this repository, you agree to be bound by the terms of this license.
        If you do not accept this repository's license, DO NOT use any code fragments from this repository for any purpose.
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: mcp>=1.27.0
Description-Content-Type: text/markdown

<!-- mcp-name: io.github.TradeSystemsNique/aidatataskrunner-mcp -->
<p align="center">
  <img src="https://img.shields.io/badge/Language-Python-3776ab?style=flat-square"/>
  <img src="https://img.shields.io/badge/Protocol-MCP-1B6CA8?style=flat-square"/>
  <img src="https://img.shields.io/badge/Platform-MetaTrader%205-0D1B2A?style=flat-square"/>
  <img src="https://img.shields.io/badge/Author-nique__372%20and%20Leo-C9D6DF?style=flat-square"/>
  <a href="./LICENSE">
    <img src="https://img.shields.io/badge/License-Nique%26Leo%20NL--ND-red.svg"/>
  </a>
</p>

<p align="center">
  <strong>Control AiDataTaskRunner Panel directly via MCP</strong>
</p>

 
---

## 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

---

## Quick Start (With claude ai)

### 1. Install MCP Server

```bash
# Install from PyPI
pip install aidatataskrunner-mcp

# Or install in development mode
pip install -e .
```

### 2. Configure in Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "aidatataskrunner": {
      "command": "aidatataskrunner-mcp",
      "args": ["--host", "127.0.0.1", "--port", "9999"]
    }
  }
}
```

### 3. 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

### 4. Use in Claude

```
Add a new EURUSD backtest from 2023.01.01 to 2024.01.01 on H1 timeframe
```

Claude will automatically translate this to the appropriate MCP call.

---

## Repository Structure

```
AiDataTaskRunerMcp/
└── aidatataskruner-mcp/                      # Python MCP server source code
    └── __init__.py
 
```

---

## Requirements

### Python
- Python >= 3.10
- Dependencies listed in `requirements.txt` and `pyproject.toml`

### MetaTrader 5
- AiDataTaskRunner Panel installed and configured
- MCP connection enabled in the AI tab
- Network connectivity between Claude and MT5 (default: localhost:9999)

---

## Installation of Repository Code

### Clone
```bash
git clone https://github.com/TradeSystemsNique/AiDataTaskRunerMcp.git
cd AiDataTaskRunerMcp
```

### Install for Development
```bash
pip install -e .
```

### Run Locally
```bash
aidatataskrunner-mcp
```
### Contact me
Contact me privately on MQL5 chats (user: nique_372) to be added as a collaborator with your MQL5 nickname (read-only access), which will make the repository automatically appear in your Shared Projects folder.

### Fork
Fork the repository.

---

## 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](./LICENSE)**
By downloading or using this repository, you accept the license terms.

---

## Documentation

Full documentation is available in the main repository:
- [AiDataTaskRunner Wiki](https://forge.mql5.io/nique_372/AiDataTaskRuner/wiki)
- [MCP Integration Guide](https://forge.mql5.io/nique_372/AiDataTaskRuner/wiki/AiMCP)
- [MCP Integration Guide with claude](https://forge.mql5.io/nique_372/AiDataTaskRuner/wiki/AiMcpClaude)

 
---

<p align="center">Copyright © 2026 Nique-Leo.</p>