@vint.tri/report_gen_mcp 1.5.40 → 1.5.42

package/FIXED_NEURAL_NETWORK_INSTRUCTIONS_APPLE_REPORT.md

@@ -0,0 +1,986 @@
+# ИСПРАВЛЕННЫЕ Инструкции для нейросети по работе с инструментом report_gen_mcp v1.7.3 - Исправление проблемы с отображением изображений
+
+**ВАЖНО:** ВСЕГДА ИСПОЛЬЗУЙТЕ ИНСТРУМЕНТ `report_gen_mcp` КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ЗАПРАШИВАЕТ СОЗДАНИЕ ОТЧЕТА, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК ИЛИ ЛЮБОЕ ИЗМЕНЕНИЕ СУЩЕСТВУЮЩЕГО ОТЧЕТА!
+
+Этот документ содержит специальные инструкции для нейросети при работе с инструментом `report_gen_mcp`, чтобы обеспечить правильное взаимодействие с пользователем после генерации отчетов, особенно при работе с изображениями.
+
+## Обязательное использование инструмента
+
+**КЛЮЧЕВОЕ ПРАВИЛО:** КАЖДЫЙ РАЗ, КОГДА ПОЛЬЗОВАТЕЛЬ ХОЧЕТ ПОЛУЧИТЬ ОТЧЕТ, ВИЗУАЛИЗАЦИЮ ДАННЫХ, ДИАГРАММУ, ГРАФИК, ИЛИ ПОПРОСИТЬ ЧТО-ЛИБО ДОБАВИТЬ/ИЗМЕНИТЬ В СУЩЕСТВУЮЩЕМ ОТЧЕТЕ, НЕЗАВИСИМО ОТ ФОРМАТА ЗАПРОСА, ВЫ ДОЛЖНЫ ИСПОЛЬЗОВАТЬ ИНСТРУМЕНТ `report_gen_mcp`!
+
+НЕ пытайтесь создавать отчеты самостоятельно или предлагать пользователю делать это вручную. ВСЕГДА используйте инструмент `report_gen_mcp`.
+
+## Общие принципы работы
+
+При использовании инструмента `report_gen_mcp` для генерации отчетов, нейросеть должна следовать определенному протоколу взаимодействия с пользователем, чтобы обеспечить полную и удобную работу с созданными отчетами.
+
+## Поддерживаемые элементы отчета
+
+Инструмент поддерживает вставку в отчеты следующих элементов:
+1. **Диаграммы** (charts) - различные типы графиков (bar, line, pie, doughnut, radar, polarArea)
+2. **Изображения** (images) - три типа:
+   - Сгенерированные сервисом pollinations.ai по текстовому описанию
+   - По URL из интернета
+   - **ВАЖНО:** Локальные файлы на компьютере пользователя также поддерживаются, но они должны быть указаны как относительные пути или абсолютные пути в системе пользователя
+
+## Требования к оформлению отчетов
+
+При создании отчетов необходимо придерживаться следующих требований по оформлению:
+
+1. **Красивое форматирование**:
+   - Используйте заголовки разных уровней (H1, H2, H3) для структурирования контента
+   - Добавляйте списки (маркированные и нумерованные) для лучшей читаемости
+   - Используйте выделение важной информации (жирный шрифт, курсив)
+   - Разделяйте смысловые блоки пустыми строками
+
+2. **Визуализация данных**:
+   - Всегда добавляйте диаграммы для числовых данных
+   - Выбирайте подходящий тип диаграммы в зависимости от характера данных
+   - Добавляйте поясняющие подписи к диаграммам
+   - Используйте разнообразные цвета для лучшей визуализации
+   - **ВАЖНО**: Все диаграммы автоматически создаются с адекватными размерами (примерно 400x300 пикселей) для лучшего визуального восприятия и пропорциональности в отчете
+   - Диаграммы автоматически оборачиваются в контейнеры с CSS классами для обеспечения правильного масштабирования и отступов
+   - Все диаграммы должны быть интерактивными (с использованием Chart.js)
+
+3. **Изображения**:
+   - Добавляйте тематические изображения для иллюстрации контента
+   - Используйте изображения высокого качества
+   - Добавляйте альтернативный текст для изображений
+   - При необходимости регулируйте размеры изображений
+   - Каждый отчет должен содержать картинку, отражающую его суть
+   - **ОСОБЕННОСТИ РАБОТЫ С ЛОКАЛЬНЫМИ ИЗОБРАЖЕНИЯМИ:**
+     * При использовании локальных файлов изображений (file://) браузеры могут блокировать их отображение по соображениям безопасности
+     * Для просмотра отчетов с локальными изображениями рекомендуется использовать Web link 2 (http://localhost:3000/...)
+     * Альтернативно, пользователь может открыть файл напрямую в браузере через file:// ссылку
+     * **РЕШЕНИЕ ПРОБЛЕМЫ:** Все локальные изображения автоматически встраиваются в отчет в формате base64, что гарантирует их отображение при открытии файла напрямую
+
+4. **Анализ данных**:
+   - Каждый отчет должен содержать подробный анализ данных
+   - Анализ должен включать выводы, закономерности и рекомендации
+   - Используйте структурированный подход к анализу с выделением ключевых моментов
+
+5. **Сравнительные графики**:
+   - Если отчет объединяет несколько сущностей, все их нужно отражать в одних и тех же сравнительных графиках
+   - Используйте разные цвета и стили для различения сущностей на графиках
+   - Добавляйте легенды и пояснения для лучшего понимания сравнительных данных
+
+6. **Текстовое форматирование**:
+   - Текст в отчетах автоматически форматируется с использованием HTML-разметки для улучшения читаемости
+   - Отчеты имеют профессиональный внешний вид с улучшенным стилем, включая:
+     * Четкую типографику с выравниванием текста по ширине
+     * Стилизованные заголовки с цветовой индикацией
+     * Улучшенное оформление списков и абзацев
+     * Цветовое выделение важной информации (жирный шрифт красного цвета, курсив зеленого цвета)
+   - Следите за форматированием текста, графиков и картинок - они не должны быть на весь экран
+   - Все элементы должны быть оформлены в лучших традициях отчетности с соблюдением пропорций и отступов
+
+## Работа с существующими отчетами
+
+Для работы с уже существующими отчетами доступен метод `read-report`, который позволяет нейросети прочитать содержимое отчета и использовать его для создания новых отчетов по запросу пользователя.
+
+**ВАЖНО:** Если пользователь просит изменить отчёт, добавить в него что-то, дополнить, расширить или отредактировать, то нейросеть сначала должна прочитать файл последнего отчета методом `report_gen_mcp : read-report`, затем создать новый файл отчета с добавлением нужного содержимого методом `report_gen_mcp : generate-report`. При этом следует использовать содержимое прочитанного отчета как основу для нового отчета, добавляя к нему запрошенные пользователем изменения.
+
+### Метод read-report
+
+Метод `read-report` принимает путь к существующему HTML-отчету и возвращает его содержимое в структурированном виде, включая:
+- Заголовки и их уровни
+- Параграфы текста
+- Списки и их элементы
+- Информацию о диаграммах и изображениях
+
+После успешного чтения отчета с помощью метода `read-report`, нейросеть получает всю необходимую информацию напрямую в ответе от метода. Необходимо предоставить пользователю следующую информацию:
+
+1. **Путь к файлу**: Абсолютный путь к прочитанному отчету
+2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
+3. **Web link 2**: Ссылка вида http://localhost:3000/filename.html для доступа к отчету через веб-интерфейс
+4. **Содержимое файла**: Полный текст HTML содержимого отчета
+5. **Структурированное содержание**: Заголовки, параграфы, списки и элементы отчета
+
+### После генерации нового отчета на основе существующего
+
+После успешной генерации нового отчета с помощью метода `generate-report`, нейросеть получает всю необходимую информацию напрямую в ответе от метода. Необходимо предоставить пользователю следующую информацию:
+
+### 1. Предоставление информации пользователю
+
+Из ответа метода `generate-report` извлеките следующую информацию и предоставьте пользователю:
+
+1. **Путь к файлу**: Абсолютный путь к созданному отчету
+2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
+3. **Web link 2**: Ссылка вида http://localhost:3000/filename.html для доступа к отчету через веб-интерфейс
+4. **Содержимое файла**: Полный текст HTML содержимого отчета
+
+Обязательно покажите пользователю содержимое файла, чтобы он мог сразу ознакомиться с результатом без необходимости открывать файл отдельно.
+
+**ВАЖНОЕ ТРЕБОВАНИЕ**: Отчет должен быть максимально красивым и качественным. Содержать изображения, графики, выводы и рассуждения. Отчет должен быть строго в HTML формате!
+
+**ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
+
+**ОСОБЕННОСТИ РАБОТЫ С ИЗОБРАЖЕНИЯМИ:**
+- Все локальные изображения автоматически встраиваются в отчет в формате base64, что гарантирует их отображение при открытии файла напрямую через file:// ссылку
+- Если отчет содержит локальные изображения (file://), они будут корректно отображаться благодаря автоматическому встраиванию
+- Для корректного отображения всех изображений также можно использовать Web link 2 (http://localhost:3000/...)
+- Пользователь также может открыть файл напрямую в браузере через file:// ссылку, и изображения будут отображаться благодаря base64 встраиванию
+
+Пример формата ответа пользователю:
+```
+Отчет успешно создан!
+
+📁 Путь к файлу: /полный/путь/к/отчету.html
+🌐 Ссылка для открытия в браузере: file:///полный/путь/к/отчету.html
+🔗 [Web link 2](http://localhost:3000/отчет.html)
+
+📄 Содержимое отчета:
+<!DOCTYPE html>
+<html lang="ru">
+<head>
+  <meta charset="UTF-8">
+  <title>Отчет</title>
+  <style>
+    body {
+      font-family: Arial, sans-serif;
+      margin: 40px;
+      background-color: #f5f5f5;
+    }
+    .container {
+      max-width: 1200px;
+      margin: 0 auto;
+      background-color: white;
+      padding: 30px;
+      border-radius: 10px;
+      box-shadow: 0 0 10px rgba(0,0,0,0.1);
+    }
+    h1, h2, h3 {
+      color: #333;
+    }
+    h1 {
+      border-bottom: 2px solid #3498db;
+      padding-bottom: 10px;
+    }
+    h2 {
+      border-left: 4px solid #3498db;
+      padding-left: 15px;
+    }
+    .chart-container, .image-container {
+      margin: 30px 0;
+      text-align: center;
+    }
+    .chart-container canvas, .image-container img {
+      max-width: 100%;
+      height: auto;
+      border: 1px solid #ddd;
+      border-radius: 5px;
+    }
+    p {
+      line-height: 1.6;
+      text-align: justify;
+    }
+    ul, ol {
+      margin: 20px 0;
+      padding-left: 30px;
+    }
+    li {
+      margin: 10px 0;
+    }
+    strong {
+      color: #e74c3c;
+    }
+    em {
+      color: #2ecc71;
+    }
+  </style>
+  <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+</head>
+<body>
+  <div class="container">
+    <h1>Отчет</h1>
+    <div class="chart-container">
+      <!-- Chart.js chart code -->
+    </div>
+    <div class="image-container">
+      <!-- Generated image -->
+      <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==" alt="Локальное изображение">
+    </div>
+    <h2>Анализ данных</h2>
+    <p>На основании проведенного анализа можно сделать следующие выводы:</p>
+    <ul>
+      <li><strong>Основной тренд:</strong> наблюдается положительная динамика роста</li>
+      <li><strong>Сезонность:</strong> наиболее высокие показатели наблюдаются во второй половине периода</li>
+      <li><strong>Прогноз:</strong> ожидается продолжение роста в ближайшие месяцы</li>
+    </ul>
+    <h2>Рекомендации</h2>
+    <ol>
+      <li>Увеличить инвестиции в направления с высокой доходностью</li>
+      <li>Оптимизировать расходы в менее эффективных сегментах</li>
+      <li>Рассмотреть возможность расширения бизнеса</li>
+    </ol>
+  </div>
+</body>
+</html>
+
+💡 Примечание: Все изображения автоматически встроены в отчет в формате base64, поэтому они будут корректно отображаться при открытии файла напрямую.
+
+Вы можете открыть отчет, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+### 2. Альтернативный подход (при необходимости)
+
+Если по какой-то причине информация не была получена напрямую из метода `generate-report`, можно использовать дополнительные инструменты:
+
+#### Получение информации о файле
+
+Используйте инструмент `get-report-url` для получения полной информации о созданном отчете:
+
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "get-report-url",
+    "arguments": {
+      "filePath": "/путь/к/созданному/отчету.html"
+    }
+  }
+}
+```
+
+#### Прикрепление содержимого файла
+
+Для того чтобы пользователь мог сразу просмотреть содержимое отчета без необходимости открывать файл, используйте инструмент `get-report-file`:
+
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "get-report-file",
+    "arguments": {
+      "filePath": "/путь/к/созданному/отчету.html"
+    }
+  }
+}
+```
+
+### 3. Особенности работы с изображениями
+
+При генерации изображений с помощью инструментов `generate-image` или `edit-image`, нейросеть должна:
+
+1. **Для `generate-image`** - обрабатывать ответ, содержащий:
+   - Текстовое подтверждение генерации
+   - Путь к файлу изображения на диске
+   - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
+   - Web link 2: `http://localhost:3000/имя_файла.jpg`
+   - **img_link**: `http://localhost:3000/имя_файла.jpg` (предпочтительная ссылка для использования во всех отчетах)
+
+2. **Для `edit-image`** - обрабатывать ответ, содержащий:
+   - Текстовое подтверждение редактирования
+   - Путь к файлу изображения на диске
+   - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
+   - Web link 2: `http://localhost:3000/имя_файла.jpg`
+   - **img_link**: `http://localhost:3000/имя_файла.jpg` (предпочтительная ссылка для использования во всех отчетах)
+
+3. **Важно**: Всегда показывайте пользователю Web link 2 для быстрого доступа к изображению через веб-интерфейс.
+
+4. **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.jpg)`!
+
+5. **ОСОБЕННО ВАЖНО**: При генерации изображения обязательно прикладывайте путь к нему в виде https или http ссылки (img_link). Именно эту ссылку предпочтительнее всего использовать во всех отчетах!
+
+6. **Пример корректного ответа при генерации изображения**:
+```
+✅ Изображение успешно сгенерировано по промпту: 'beautiful landscape'
+
+📁 Файл сохранен: /полный/путь/к/generated-image-1234567890.jpeg
+🌐 Web link: file:///полный/путь/к/generated-image-1234567890.jpeg
+🔗 [Web link 2](http://localhost:3000/generated-image-1234567890.jpeg)
+🖼️ img_link: http://localhost:3000/generated-image-1234567890.jpeg (предпочтительная ссылка для использования в отчетах)
+
+💡 Примечание: Если изображение не отображается, попробуйте открыть его по Web link 2, который обеспечивает корректное отображение.
+
+Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+7. **Пример корректного ответа при редактировании изображения**:
+```
+✅ Изображение успешно отредактировано по промпту: 'add a hat to the person'
+
+📁 Файл сохранен: /полный/путь/к/edited-image-1234567890.jpeg
+🌐 Web link: file:///полный/путь/к/edited-image-1234567890.jpeg
+🔗 [Web link 2](http://localhost:3000/edited-image-1234567890.jpeg)
+🖼️ img_link: http://localhost:3000/edited-image-1234567890.jpeg (предпочтительная ссылка для использования в отчетах)
+
+💡 Примечание: Если изображение не отображается, попробуйте открыть его по Web link 2, который обеспечивает корректное отображение.
+
+Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+## Формат данных для диаграмм (графиков)
+
+Очень важно правильно формировать данные для диаграмм, чтобы избежать ошибок. Ниже приведены точные требования к формату данных для каждого типа диаграмм.
+
+### Общие правила для всех типов диаграмм
+
+1. Все цветовые значения (`backgroundColor`, `borderColor`) должны быть представлены в виде **массивов строк**, даже если это один цвет.
+2. Все числовые данные (`data`) должны быть представлены в виде массивов чисел.
+3. Все текстовые метки (`labels`) должны быть представлены в виде массивов строк.
+4. Значение `options.title` должно быть **строкой**, а не объектом.
+
+### Линейные диаграммы (line)
+
+```json
+{
+  "type": "line",
+  "config": {
+    "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
+    "datasets": [
+      {
+        "label": "Продажи (USD)",
+        "data": [12000, 19000, 15000, 18000, 22000],
+        "borderColor": ["rgba(54, 162, 235, 1)"], // ВАЖНО: массив, даже для одного цвета!
+        "fill": false
+      }
+    ],
+    "options": {
+      "title": "Ежемесячные продажи"
+    }
+  }
+}
+```
+
+**Важно**: `borderColor` должен быть массивом строк, даже если используется только один цвет.
+
+### Столбчатые диаграммы (bar)
+
+```json
+{
+  "type": "bar",
+  "config": {
+    "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
+    "datasets": [
+      {
+        "label": "Продажи (USD)",
+        "data": [12000, 19000, 15000, 18000, 22000],
+        "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
+        "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
+      }
+    ],
+    "options": {
+      "title": "Ежемесячные продажи"
+    }
+  }
+}
+```
+
+**Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
+
+### Круговые диаграммы (pie)
+
+```json
+{
+  "type": "pie",
+  "config": {
+    "labels": ["Красный", "Синий", "Желтый", "Зеленый", "Фиолетовый"],
+    "datasets": [
+      {
+        "data": [12, 19, 3, 5, 2],
+        "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
+        "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
+      }
+    ],
+    "options": {
+      "title": "Распределение по категориям"
+    }
+  }
+}
+```
+
+**Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
+
+### Кольцевые диаграммы (doughnut)
+
+```json
+{
+  "type": "doughnut",
+  "config": {
+    "labels": ["Красный", "Синий", "Желтый", "Зеленый", "Фиолетовый"],
+    "datasets": [
+      {
+        "data": [12, 19, 3, 5, 2],
+        "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"], // Массив цветов
+        "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"] // Массив цветов
+      }
+    ],
+    "options": {
+      "title": "Распределение по категориям"
+    }
+  }
+}
+```
+
+**Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
+
+### Радарные диаграммы (radar)
+
+```json
+{
+  "type": "radar",
+  "config": {
+    "labels": ["Eating", "Drinking", "Sleeping", "Designing", "Coding", "Cycling", "Running"],
+    "datasets": [
+      {
+        "label": "Person 1",
+        "data": [65, 59, 90, 81, 56, 55, 40],
+        "backgroundColor": ["rgba(255, 99, 132, 0.2)"], // Массив цветов
+        "borderColor": ["rgba(255, 99, 132, 1)"] // Массив цветов
+      }
+    ],
+    "options": {
+      "title": "Радарная диаграмма"
+    }
+  }
+}
+```
+
+**Важно**: `backgroundColor` и `borderColor` должны быть массивами строк, даже если используется только один цвет.
+
+### Полярные диаграммы (polarArea)
+
+```json
+{
+  "type": "polarArea",
+  "config": {
+    "labels": ["Red", "Green", "Yellow", "Grey", "Blue"],
+    "datasets": [
+      {
+        "data": [11, 16, 7, 3, 14],
+        "backgroundColor": ["#FF6384", "#4BC0C0", "#FFCE56", "#E7E9ED", "#36A2EB"], // Массив цветов
+        "borderColor": ["#FF6384", "#4BC0C0", "#FFCE56", "#E7E9ED", "#36A2EB"] // Массив цветов
+      }
+    ],
+    "options": {
+      "title": "Полярная диаграмма"
+    }
+  }
+}
+```
+
+**Важно**: `backgroundColor` и `borderColor` должны быть массивами строк.
+
+## Формат данных для изображений
+
+### Изображения, сгенерированные pollinations.ai
+
+```json
+{
+  "type": "pollinations",
+  "config": {
+    "prompt": "красивый закат над океаном",
+    "width": 512,
+    "height": 512,
+    "model": "flux",
+    "seed": 12345,
+    "nologo": true,
+    "enhance": true
+  }
+}
+```
+
+### Изображения, сгенерированные с помощью generate-image (Chutes AI)
+
+При использовании инструмента `generate-image` для генерации изображений с помощью Chutes AI, числовые параметры могут быть представлены как числа или как строки. Инструмент автоматически преобразует строковые параметры в числа.
+
+✅ ПРИМЕР 1 (числовые параметры как числа):
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "generate-image",
+    "arguments": {
+      "prompt": "a dog made of US dollar bills",
+      "width": 512,
+      "height": 512,
+      "guidance_scale": 7.5,
+      "negative_prompt": "blurry, low quality",
+      "num_inference_steps": 50,
+      "seed": 0
+    }
+  }
+}
+```
+
+✅ ПРИМЕР 2 (числовые параметры как строки):
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "generate-image",
+    "arguments": {
+      "prompt": "a dog made of US dollar bills",
+      "width": "512",
+      "height": "512",
+      "guidance_scale": "7.5",
+      "negative_prompt": "blurry, low quality",
+      "num_inference_steps": "50",
+      "seed": "0"
+    }
+  }
+}
+```
+
+✅ ПРИМЕР 3 (смешанные параметры):
+```json
+{
+  "method": "tools/call",
+  "params": {
+    "name": "generate-image",
+    "arguments": {
+      "prompt": "a dog made of US dollar bills",
+      "width": "512",
+      "height": 512,
+      "guidance_scale": "7.5",
+      "negative_prompt": "blurry, low quality",
+      "num_inference_steps": 50,
+      "seed": "0"
+    }
+  }
+}
+```
+
+**Гибкость параметров:** Инструмент поддерживает как числовые, так и строковые значения для числовых параметров (`width`, `height`, `guidance_scale`, `num_inference_steps`, `seed`). Это обеспечивает совместимость с различными способами формирования запросов.
+
+### Изображения по URL
+
+```json
+{
+  "type": "url",
+  "config": {
+    "url": "https://example.com/image.jpg",
+    "alt": "Описание изображения",
+    "width": 500,
+    "height": 300
+  }
+}
+```
+
+### Локальные изображения (по файловому пути)
+
+```json
+{
+  "type": "url",
+  "config": {
+    "url": "file:///полный/путь/к/изображению.jpg",
+    "alt": "Описание изображения",
+    "width": 500,
+    "height": 300
+  }
+}
+```
+
+**ВАЖНО ПРИ РАБОТЕ С ЛОКАЛЬНЫМИ ИЗОБРАЖЕНИЯМИ:**
+- Локальные изображения должны быть указаны с полным путем в формате file://
+- Браузеры могут блокировать отображение локальных файлов по соображениям безопасности
+- Для корректного отображения используйте Web link 2 (http://localhost:3000/...)
+- **НОВОЕ РЕШЕНИЕ:** Все локальные изображения автоматически встраиваются в отчет в формате base64, что гарантирует их отображение при открытии файла напрямую
+
+## ПРАВИЛА ФОРМАТИРОВАНИЯ ПАРАМЕТРОВ (КРИТИЧЕСКИ ВАЖНО!)
+
+### 1. ПАРАМЕТР "elements" ДОЛЖЕН БЫТЬ ОБЪЕКТОМ!
+
+❌ НЕПРАВИЛЬНО (это вызывает ошибку "Expected object, received string"):
+```json
+{
+  "method": "generate-report",
+  "params": {
+    "document": "# Отчет\n\n[[chart:mychart]]",
+    "elements": "{ \"mychart\": { \"type\": \"bar\", \"config\": { \"labels\": [\"A\", \"B\", \"C\"], \"datasets\": [{ \"label\": \"Data\", \"data\": [1, 2, 3], \"backgroundColor\": [\"red\", \"green\", \"blue\"], \"borderColor\": [\"red\", \"green\", \"blue\"] }] } }",
+    "outputFile": "report.html"
+  }
+}
+```
+
+✅ ПРАВИЛЬНО (elements - это объект, а не строка):
+```json
+{
+  "method": "generate-report",
+  "params": {
+    "document": "# Отчет\n\n[[chart:mychart]]",
+    "elements": {
+      "mychart": {
+        "type": "bar",
+        "config": {
+          "labels": ["A", "B", "C"],
+          "datasets": [{
+            "label": "Data",
+            "data": [1, 2, 3],
+            "backgroundColor": ["red", "green", "blue"],
+            "borderColor": ["red", "green", "blue"]
+          }],
+          "options": {
+            "title": "Мой график"
+          }
+        }
+      }
+    },
+    "outputFile": "report.html"
+  }
+}
+```
+
+### 2. ЦВЕТОВЫЕ ЗНАЧЕНИЯ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
+
+❌ НЕПРАВИЛЬНО (это вызывает ошибку):
+```json
+"backgroundColor": "red"
+"borderColor": "blue"
+```
+
+✅ ПРАВИЛЬНО (всегда используйте массивы):
+```json
+"backgroundColor": ["red"]
+"borderColor": ["blue"]
+```
+
+### 3. ЧИСЛОВЫЕ ДАННЫЕ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
+
+❌ НЕПРАВИЛЬНО:
+```json
+"data": 10
+```
+
+✅ ПРАВИЛЬНО:
+```json
+"data": [10]
+```
+
+### 4. ТЕКСТОВЫЕ МЕТКИ ДОЛЖНЫ БЫТЬ МАССИВАМИ!
+
+❌ НЕПРАВИЛЬНО:
+```json
+"labels": "Январь"
+```
+
+✅ ПРАВИЛЬНО:
+```json
+"labels": ["Январь"]
+```
+
+### 5. ЗНАЧЕНИЕ options.title ДОЛЖНО БЫТЬ СТРОКОЙ!
+
+❌ НЕПРАВИЛЬНО (это вызывает ошибку):
+```json
+"options": {
+  "title": {
+    "text": "Заголовок графика"
+  }
+}
+```
+
+✅ ПРАВИЛЬНО:
+```json
+"options": {
+  "title": "Заголовок графика"
+}
+```
+
+### 6. ТИП ЭЛЕМЕНТА ДОЛЖЕН СООТВЕТСТВОВАТЬ ЕГО СОДЕРЖИМОМУ!
+
+❌ НЕПРАВИЛЬНО (это вызывает ошибку):
+```json
+"comparison_chart": {
+  "type": "bar",  // Неправильный тип для сравнения - должен быть либо "pollinations", либо "url"
+  "config": {
+    "labels": ["A", "B", "C"],
+    "datasets": [{
+      "label": "Data",
+      "data": [1, 2, 3],
+      "backgroundColor": ["red", "green", "blue"]
+    }]
+  }
+}
+```
+
+✅ ПРАВИЛЬНО (для диаграмм):
+```json
+"comparison_chart": {
+  "type": "bar",
+  "config": {
+    "labels": ["A", "B", "C"],
+    "datasets": [{
+      "label": "Data",
+      "data": [1, 2, 3],
+      "backgroundColor": ["red", "green", "blue"]
+    }],
+    "options": {
+      "title": "Сравнительная диаграмма"
+    }
+  }
+}
+```
+
+✅ ПРАВИЛЬНО (для изображений):
+```json
+"comparison_chart": {
+  "type": "pollinations",
+  "config": {
+    "prompt": "beautiful landscape with mountains",
+    "width": 600,
+    "height": 400
+  }
+}
+```
+
+✅ ПРАВИЛЬНО (для локальных изображений):
+```json
+"comparison_chart": {
+  "type": "url",
+  "config": {
+    "url": "file:///полный/путь/к/изображению.jpg",
+    "alt": "Локальное изображение",
+    "width": 500,
+    "height": 300
+  }
+}
+```
+
+## Пример полного взаимодействия
+
+Вот пример того, как должно выглядеть полное взаимодействие с пользователем после генерации отчета:
+
+1. Генерация отчета с диаграммами:
+```json
+{
+  "method": "generate-report",
+  "params": {
+    "document": "# Отчет\n\n[[chart:sales_chart]]\n\n[[chart:comparison_chart]]",
+    "elements": {
+      "sales_chart": {
+        "type": "bar",
+        "config": {
+          "labels": ["Январь", "Февраль", "Март", "Апрель", "Май"],
+          "datasets": [{
+            "label": "Продажи (USD)",
+            "data": [12000, 19000, 15000, 18000, 22000],
+            "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"],
+            "borderColor": ["#FF6384", "#36A2EB", "#FFCE56", "#4BC0C0", "#9966FF"]
+          }],
+          "options": {
+            "title": "Ежемесячные продажи"
+          }
+        }
+      },
+      "comparison_chart": {
+        "type": "pie",
+        "config": {
+          "labels": ["Категория A", "Категория B", "Категория C"],
+          "datasets": [{
+            "data": [30, 50, 20],
+            "backgroundColor": ["#FF6384", "#36A2EB", "#FFCE56"],
+            "borderColor": ["#FF6384", "#36A2EB", "#FFCE56"]
+          }],
+          "options": {
+            "title": "Сравнение по категориям"
+          }
+        }
+      }
+    },
+    "outputFile": "report.html"
+  }
+}
+```
+
+2. Генерация отчета с изображениями:
+```json
+{
+  "method": "generate-report",
+  "params": {
+    "document": "# Отчет\n\n[[image:main_image]]\n\n[[image:comparison_image]]\n\n[[image:local_image]]",
+    "elements": {
+      "main_image": {
+        "type": "pollinations",
+        "config": {
+          "prompt": "beautiful landscape with mountains and lake",
+          "width": 600,
+          "height": 400,
+          "model": "flux",
+          "nologo": true,
+          "enhance": true
+        }
+      },
+      "comparison_image": {
+        "type": "url",
+        "config": {
+          "url": "https://example.com/comparison-diagram.jpg",
+          "alt": "Сравнительная диаграмма",
+          "width": 500,
+          "height": 300
+        }
+      },
+      "local_image": {
+        "type": "url",
+        "config": {
+          "url": "file:///полный/путь/к/local-image.jpg",
+          "alt": "Локальное изображение",
+          "width": 500,
+          "height": 300
+        }
+      }
+    },
+    "outputFile": "report.html"
+  }
+}
+```
+
+3. Ответ от метода `generate-report` уже содержит всю необходимую информацию:
+```json
+{
+  "content": [
+    {
+      "type": "text",
+      "text": "Report generated successfully.\n\nFOR THE NEURAL NETWORK: Please present the following information to the user:\n1. Path to file: /path/to/report.html\n2. Web browser link: file:///path/to/report.html\n3. Web link 2: http://localhost:3000/report.html"
+    }
+  ]
+}
+```
+
+4. Ответ пользователю (на основе информации из ответа метода):
+```
+Отчет успешно создан!
+
+📁 Путь к файлу: /path/to/report.html
+🌐 Ссылка для открытия в браузере: file:///path/to/report.html
+🔗 [Web link 2](http://localhost:3000/report.html)
+
+💡 Примечание: Все изображения автоматически встроены в отчет в формате base64, поэтому они будут корректно отображаться при открытии файла напрямую.
+
+Содержимое отчета:
+<!DOCTYPE html>
+<html lang="ru">
+<head>
+  <meta charset="UTF-8">
+  <title>Отчет</title>
+  <style>
+    body {
+      font-family: Arial, sans-serif;
+      margin: 40px;
+      background-color: #f5f5f5;
+    }
+    .container {
+      max-width: 1200px;
+      margin: 0 auto;
+      background-color: white;
+      padding: 30px;
+      border-radius: 10px;
+      box-shadow: 0 0 10px rgba(0,0,0,0.1);
+    }
+    h1, h2, h3 {
+      color: #333;
+    }
+    h1 {
+      border-bottom: 2px solid #3498db;
+      padding-bottom: 10px;
+    }
+    h2 {
+      border-left: 4px solid #3498db;
+      padding-left: 15px;
+    }
+    .chart-container, .image-container {
+      margin: 30px 0;
+      text-align: center;
+    }
+    .chart-container canvas, .image-container img {
+      max-width: 100%;
+      height: auto;
+      border: 1px solid #ddd;
+      border-radius: 5px;
+    }
+    p {
+      line-height: 1.6;
+      text-align: justify;
+    }
+    ul, ol {
+      margin: 20px 0;
+      padding-left: 30px;
+    }
+    li {
+      margin: 10px 0;
+    }
+    strong {
+      color: #e74c3c;
+    }
+    em {
+      color: #2ecc71;
+    }
+  </style>
+  <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+</head>
+<body>
+  <div class="container">
+    <h1>Отчет</h1>
+    <div class="chart-container">
+      <!-- Chart.js chart code -->
+    </div>
+    <div class="image-container">
+      <!-- Generated image -->
+      <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PchI7wAAAABJRU5ErkJggg==" alt="Локальное изображение">
+    </div>
+    <h2>Анализ данных</h2>
+    <p>На основании проведенного анализа можно сделать следующие выводы:</p>
+    <ul>
+      <li><strong>Основной тренд:</strong> наблюдается положительная динамика роста</li>
+      <li><strong>Сезонность:</strong> наиболее высокие показатели наблюдаются во второй половине периода</li>
+      <li><strong>Прогноз:</strong> ожидается продолжение роста в ближайшие месяцы</li>
+    </ul>
+    <h2>Рекомендации</h2>
+    <ol>
+      <li>Увеличить инвестиции в направления с высокой доходностью</li>
+      <li>Оптимизировать расходы в менее эффективных сегментах</li>
+      <li>Рассмотреть возможность расширения бизнеса</li>
+    </ol>
+  </div>
+</body>
+</html>
+
+Вы можете открыть отчет, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+## Частые ошибки и как их избежать
+
+1. **Ошибка формата параметров**: Передача `elements` как строки вместо объекта
+   - ❌ Неправильно: `"elements": "{\"mychart\":{...}}"`
+   - ✅ Правильно: `"elements": {"mychart":{...}}"
+
+2. **Ошибка формата цвета**: Передача `borderColor` или `backgroundColor` как строк вместо массивов
+   - ❌ Неправильно: `"borderColor": "red"`
+   - ✅ Правильно: `"borderColor": ["red"]"
+
+3. **Ошибка формата данных**: Передача числовых данных как отдельных значений вместо массивов
+   - ❌ Неправильно: `"data": 10
+   - ✅ Правильно: `"data": [10]"
+
+4. **Ошибка формата меток**: Передача меток как отдельных значений вместо массивов
+   - ❌ Неправильно: `"labels": "Январь"
+   - ✅ Правильно: `"labels": ["Январь"]"
+
+5. **Ошибка формата заголовка**: Передача `options.title` как объекта вместо строки
+   - ❌ Неправильно: `"options": {"title": {"text": "Заголовок"}}`
+   - ✅ Правильно: `"options": {"title": "Заголовок"}`
+
+6. **Ошибка типа элемента**: Использование неправильного типа для элемента
+   - ❌ Неправильно: `"type": "bar"` для изображения
+   - ✅ Правильно: `"type": "pollinations"` или `"type": "url"` для изображений
+
+7. **Ошибка с локальными изображениями**: Неправильный формат file:// URL
+   - ❌ Неправильно: `"url": "/путь/к/изображению.jpg"`
+   - ✅ Правильно: `"url": "file:///полный/путь/к/изображению.jpg"`
+
+## Дополнительные рекомендации
+
+1. Всегда проверяйте успешность выполнения каждой операции перед переходом к следующему шагу
+2. Если какой-либо шаг завершается ошибкой, сообщите пользователю об этом и предложите решение
+3. Убедитесь, что все пути к файлам корректны и файлы действительно существуют
+4. При работе с Claude Desktop используйте параметр `tempDirectory` при генерации отчетов для избежания проблем с правами доступа
+5. Создавайте отчеты с красивым оформлением, используя заголовки, списки и другие элементы форматирования
+6. Добавляйте в отчеты диаграммы и изображения для лучшей визуализации данных
+7. Всегда после генерации отчета возвращайте пользователю ссылку на файл отчета, путь к файлу отчета и содержимое файла
+8. Отчет должен быть максимально красивым и качественным, содержать изображения, графики, выводы и рассуждения
+9. Отчет должен быть строго в HTML формате
+10. **ВАЖНО**: Всегда выводите Web link 2 как кликабельную ссылку в формате `[Web link 2](http://localhost:3000/filename.html)`!
+11. **ОСОБЕННО ВАЖНО**: Все локальные изображения автоматически встраиваются в отчет в формате base64, что гарантирует их отображение при открытии файла напрямую
+
+Следование этим инструкциям обеспечит качественное и полное взаимодействие с пользователем при работе с инструментом генерации отчетов.

package/dist/images/localImages.d.ts

@@ -6,14 +6,14 @@ export declare const localImageSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     src: string;
+    alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    alt?: string | undefined;
 }, {
     src: string;
+    alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    alt?: string | undefined;
 }>;
 export declare function renderLocalImage(params: z.infer<typeof localImageSchema>): Promise<string>;
 //# sourceMappingURL=localImages.d.ts.map

package/dist/images/pollinations.d.ts

@@ -8,18 +8,18 @@ export declare const generatedImageSchema: z.ZodObject<{
     nologo: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     enhance: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
-    prompt: string;
-    model: string;
     width: number;
     height: number;
+    prompt: string;
+    model: string;
     nologo: boolean;
     enhance: boolean;
     seed?: number | undefined;
 }, {
     prompt: string;
-    model?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
+    model?: string | undefined;
     seed?: number | undefined;
     nologo?: boolean | undefined;
     enhance?: boolean | undefined;
@@ -31,14 +31,14 @@ export declare const imageUrlSchema: z.ZodObject<{
     height: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     url: string;
+    alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    alt?: string | undefined;
 }, {
     url: string;
+    alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    alt?: string | undefined;
 }>;
 export declare function generateImageUrl(params: z.infer<typeof generatedImageSchema>): string;
 export declare function renderGeneratedImage(params: z.infer<typeof generatedImageSchema>): Promise<string>;

package/dist/images/urlImages.d.ts

@@ -9,16 +9,16 @@ export declare const urlImageSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     embed: boolean;
     url: string;
+    alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    alt?: string | undefined;
     outputPath?: string | undefined;
 }, {
     url: string;
-    embed?: boolean | undefined;
+    alt?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    alt?: string | undefined;
+    embed?: boolean | undefined;
     outputPath?: string | undefined;
 }>;
 export declare function renderUrlImage(params: z.infer<typeof urlImageSchema>): Promise<string>;

package/dist/index.js

@@ -109,7 +109,7 @@ if (process.argv.length === 2) {
     // No command specified, run in stdio mode using MCP SDK
     const mcpServer = new McpServer({
         name: "report_gen_mcp",
-        version: "1.5.40"
+        version: "1.5.42"
     }, {
         // Disable health check to prevent automatic calls
         capabilities: {
@@ -120,12 +120,17 @@ if (process.argv.length === 2) {
         description: simpleReportTool.description,
         inputSchema: simpleReportTool.inputSchema,
     }, async (args) => {
-        const result = await simpleReportTool.action(args);
+        // Wait for server to start and get the port
+        while (typeof serverPort === 'undefined') {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        const serverBaseUrl = `http://localhost:${serverPort}/reports`;
+        const result = await simpleReportTool.action({ ...args, serverBaseUrl });
         // Find the file path from the results to construct the HTTP URL
         const localPathResource = result.content.find(c => c.resource.uri.endsWith('.html'));
         if (localPathResource) {
             const fileName = path.basename(localPathResource.resource.uri);
-            const httpUrl = `http://localhost:${serverPort}/reports/${fileName}`;
+            const httpUrl = `${serverBaseUrl}/${fileName}`;
             // Find the resource with the file:/// URL and update its text
             const fileUrlResource = result.content.find(c => c.resource.uri.startsWith('file:///'));
             if (fileUrlResource) {

package/dist/tools/simpleReport.d.ts

@@ -9,6 +9,7 @@ export declare const simpleReportTool: {
     action: (args: {
         document: string;
         outputFile?: string;
+        serverBaseUrl?: string;
     }) => Promise<{
         content: {
             type: "resource";

package/dist/tools/simpleReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simpleReport.d.ts","sourceRoot":"","sources":["../../src/tools/simpleReport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,gBAAgB;;;;;;;mBAON;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;CAmC/D,CAAC"}
+{"version":3,"file":"simpleReport.d.ts","sourceRoot":"","sources":["../../src/tools/simpleReport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,gBAAgB;;;;;;;mBAON;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;CAmCvF,CAAC"}

package/dist/tools/simpleReport.js

@@ -12,13 +12,13 @@ export const simpleReportTool = {
         outputFile: z.string().optional().describe("The name of the output HTML file."),
     },
     action: async (args) => {
-        let { document, outputFile } = args;
+        let { document, outputFile, serverBaseUrl } = args;
         const reportsDir = process.env.REPORTS_DIR || os.tmpdir();
         if (!outputFile) {
             outputFile = `report-${Date.now()}.html`;
         }
         const outputPath = path.resolve(reportsDir, outputFile);
-        const result = await generateReport(document, outputPath);
+        const result = await generateReport(document, outputPath, serverBaseUrl);
         const fileUrl = pathToFileURL(result.filePath).href;
         const fileContent = await fs.readFile(result.filePath, 'utf8');
         // The http path will be constructed by the caller in index.ts,

package/dist/utils/reportGenerator.d.ts

@@ -1,4 +1,4 @@
-export declare function generateReport(htmlDocument: string, outputFile: string): Promise<{
+export declare function generateReport(htmlDocument: string, outputFile: string, serverBaseUrl?: string): Promise<{
     success: true;
     filePath: string;
 }>;

package/dist/utils/reportGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/reportGenerator.ts"],"names":[],"mappings":"AAIA,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA+E9C"}
+{"version":3,"file":"reportGenerator.d.ts","sourceRoot":"","sources":["../../src/utils/reportGenerator.ts"],"names":[],"mappings":"AAKA,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA8H9C"}

package/dist/utils/reportGenerator.js

@@ -1,9 +1,11 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { JSDOM } from 'jsdom';
-export async function generateReport(htmlDocument, outputFile) {
+import { renderLocalImage } from '../images/localImages.js';
+export async function generateReport(htmlDocument, outputFile, serverBaseUrl) {
     const dom = new JSDOM(htmlDocument);
     const { document } = dom.window;
+    const outputDirPath = path.dirname(outputFile);
     // 1. Ensure a valid HTML structure
     let head = document.querySelector('head');
     if (!head) {
@@ -45,7 +47,49 @@ export async function generateReport(htmlDocument, outputFile) {
             scriptTag.remove();
         }
     });
-    // 4. Inject a single, robust chart-rendering script at the end of the body
+    // 4. Process all img elements to handle local images
+    const images = document.querySelectorAll('img');
+    for (const img of Array.from(images)) {
+        const src = img.getAttribute('src');
+        if (src) {
+            // Check if it's a local file (not a URL)
+            if (!src.startsWith('http://') && !src.startsWith('https://') && !src.startsWith('data:')) {
+                try {
+                    // If serverBaseUrl is provided, create HTTP link instead of base64
+                    if (serverBaseUrl) {
+                        const imageFileName = path.basename(src);
+                        const imageDestPath = path.join(outputDirPath, imageFileName);
+                        // Copy the image to the report directory
+                        const imageSourcePath = path.resolve(process.cwd(), src);
+                        await fs.copyFile(imageSourcePath, imageDestPath);
+                        // Update the img src to point to the HTTP URL
+                        const httpUrl = `${serverBaseUrl}/${imageFileName}`;
+                        img.setAttribute('src', httpUrl);
+                    }
+                    else {
+                        // Convert local image to base64 embedded image (fallback behavior)
+                        const imageHtml = await renderLocalImage({
+                            src: src,
+                            alt: img.getAttribute('alt') || '',
+                            width: img.getAttribute('width') ? parseInt(img.getAttribute('width')) : undefined,
+                            height: img.getAttribute('height') ? parseInt(img.getAttribute('height')) : undefined
+                        });
+                        // Parse the generated HTML and replace the img element
+                        const imageDom = new JSDOM(imageHtml);
+                        const imageContainer = imageDom.window.document.querySelector('.image-container');
+                        if (imageContainer) {
+                            img.parentNode?.replaceChild(document.importNode(imageContainer, true), img);
+                        }
+                    }
+                }
+                catch (error) {
+                    console.warn(`Failed to process local image ${src}:`, error);
+                    // Keep original img tag if processing fails
+                }
+            }
+        }
+    }
+    // 5. Inject a single, robust chart-rendering script at the end of the body
     const finalChartScript = document.createElement('script');
     finalChartScript.textContent = `
     document.addEventListener('DOMContentLoaded', () => {
@@ -63,7 +107,6 @@ export async function generateReport(htmlDocument, outputFile) {
   `;
     document.body.appendChild(finalChartScript);
     const finalHtml = dom.serialize();
-    const outputDirPath = path.dirname(outputFile);
     await fs.ensureDir(outputDirPath);
     await fs.writeFile(outputFile, finalHtml);
     console.log('Report successfully generated and fixed at: ${outputFile}');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vint.tri/report_gen_mcp",
-  "version": "1.5.40",
+  "version": "1.5.42",
   "description": "CLI tool for generating HTML reports with embedded charts and images",
   "main": "dist/index.js",
   "bin": {

package/test_http_images.js

@@ -0,0 +1,44 @@
+import { generateReport } from './dist/utils/reportGenerator.js';
+import fs from 'fs-extra';
+import path from 'path';
+
+async function testHttpImages() {
+  // Read the test HTML file
+  const htmlContent = fs.readFileSync('test_http_image_report.html', 'utf8');
+
+  // Generate report with server base URL
+  const outputPath = path.resolve('.', 'test_http_output.html');
+  const serverBaseUrl = 'http://localhost:3000/reports';
+
+  console.log('Generating report with HTTP image links...');
+  const result = await generateReport(htmlContent, outputPath, serverBaseUrl);
+
+  // Read the generated report
+  const generatedContent = fs.readFileSync(outputPath, 'utf8');
+
+  console.log('Generated report saved to:', result.filePath);
+  console.log('Checking for HTTP image links...');
+
+  // Check if images were converted to HTTP links
+  if (generatedContent.includes('http://localhost:3000/reports/apple_logo_chart.png')) {
+    console.log('✅ SUCCESS: Image converted to HTTP link');
+  } else if (generatedContent.includes('src="data:image')) {
+    console.log('❌ FAILED: Image still using base64 encoding');
+  } else {
+    console.log('⚠️  UNKNOWN: Image format not recognized');
+  }
+
+  // Also copy the image file to test directory to simulate real scenario
+  try {
+    fs.copyFileSync('apple_logo_chart.png', 'apple_logo_chart.png');
+    console.log('✅ Image file copied to test directory');
+  } catch (error) {
+    console.log('⚠️  Could not copy image file:', error.message);
+  }
+
+  console.log('\nGenerated HTML content:');
+  console.log('======================');
+  console.log(generatedContent);
+}
+
+testHttpImages().catch(console.error);