@vint.tri/report_gen_mcp 1.4.0 → 1.4.2

package/NEURAL_NETWORK_IMAGE_RESPONSE_FIX.md

@@ -0,0 +1,58 @@
+# Fix for Neural Network Image Response Behavior
+
+## Issue Description
+When generating images using the MCP tools, the neural network was not providing the proper response format including:
+1. HTTP path for browser access (`http://localhost:3000/reports/filename.jpg`)
+2. Automatic image insertion in responses when receiving image generation results
+
+## Root Cause
+The neural network instructions did not specify the proper response format for image generation tools, particularly:
+- Missing requirement to provide HTTP links for localhost access
+- Missing instruction for automatic image embedding in responses
+- Incomplete example response format
+
+## Solution Implemented
+
+### 1. Updated Neural Network Instructions
+Modified both `NEURAL_NETWORK_INSTRUCTIONS.md` and `UPDATED_NEURAL_NETWORK_INSTRUCTIONS.md` to include:
+
+#### New Section: Особенности работы с изображениями (Image Handling Features)
+Added detailed instructions for how neural networks should handle image generation responses:
+
+1. **For `generate_image_to_file` tool usage** - Always return to user:
+   - File path on disk
+   - HTTP link for web server access (when server is running): `http://localhost:3000/reports/filename.jpg`
+   - File URL for browser opening: `file:///full/path/to/file.jpg`
+
+2. **Proper response example**:
+```
+✅ Изображение успешно сгенерировано!
+
+📁 Путь к файлу: /full/path/to/lizard_wedding_bitter.jpg
+🌐 Ссылка для открытия в браузере: file:///full/path/to/lizard_wedding_bitter.jpg
+🔗 HTTP ссылка: http://localhost:3000/reports/lizard_wedding_bitter.jpg
+
+Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+3. **Automatic image embedding** - When the neural network receives a response with generated image information, it should automatically embed the image in its response to the user via the HTTP link if available.
+
+### 2. Test Verification
+Created `test-neural-network-image-response.js` to verify the proper response format:
+- Simulates the expected neural network response for image generation
+- Shows proper file path, browser URL, and HTTP link formatting
+- Demonstrates automatic image embedding in responses
+
+## Files Modified
+1. `NEURAL_NETWORK_INSTRUCTIONS.md` - Updated with image handling instructions
+2. `UPDATED_NEURAL_NETWORK_INSTRUCTIONS.md` - Updated with image handling instructions
+3. `test-neural-network-image-response.js` - Created test script to verify behavior
+
+## Expected Behavior
+After this fix, when a neural network generates an image using the `generate_image_to_file` tool, it will:
+1. Provide the full file path to the generated image
+2. Include a clickable file:// URL for direct browser opening
+3. Include an HTTP link in the format `http://localhost:3000/reports/filename.jpg` for web access
+4. Automatically embed the image in its response using the HTTP link when appropriate
+
+This resolves the user's issue where the response was missing the HTTP path and automatic image insertion behavior.

package/NEURAL_NETWORK_INSTRUCTIONS.md

@@ -159,6 +159,29 @@
 }
 ```
 
+### 3. Особенности работы с изображениями
+
+При генерации изображений с помощью инструментов `generate_image` или `generate_image_to_file`, нейросеть должна:
+
+1. **При использовании `generate_image_to_file`** - всегда возвращать пользователю:
+   - Путь к файлу изображения на диске
+   - HTTP ссылку для доступа к изображению через веб-сервер (если сервер запущен): `http://localhost:3000/reports/имя_файла.jpg`
+   - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
+
+2. **Пример корректного ответа при генерации изображения**:
+```
+✅ Изображение успешно сгенерировано!
+
+📁 Путь к файлу: /полный/путь/к/lizard_wedding_bitter.jpg
+🌐 Ссылка для открытия в браузере: file:///полный/путь/к/lizard_wedding_bitter.jpg
+🔗 HTTP ссылка: http://localhost:3000/reports/lizard_wedding_bitter.jpg
+
+Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+3. **Автоматическая вставка изображений** - когда нейросеть получает ответ с информацией о сгенерированном изображении, она должна автоматически вставлять изображение в свой ответ пользователю по HTTP ссылке, если она доступна.
+```
+
 ## Формат данных для диаграмм (графиков)
 
 Очень важно правильно формировать данные для диаграмм, чтобы избежать ошибок. Ниже приведены точные требования к формату данных для каждого типа диаграмм.

package/PUBLICATION_CONFIRMATION_V1.4.1.md

@@ -0,0 +1,29 @@
+# Publication Confirmation - Version 1.4.1
+
+This document confirms that version 1.4.1 of the `@vint.tri/report_gen_mcp` package has been successfully published to npm.
+
+## Publication Details
+- Package Name: `@vint.tri/report_gen_mcp`
+- Version: 1.4.1
+- Publication Date: August 25, 2025
+- Registry: npm (https://registry.npmjs.org/)
+
+## Verification
+The package has been published with consistent versioning across:
+- package.json
+- MCP server configuration in src/index.ts
+- Compiled distribution files
+
+## Access
+The package can be installed using:
+```bash
+npm install @vint.tri/report_gen_mcp@1.4.1
+```
+
+Or as the latest version:
+```bash
+npm install @vint.tri/report_gen_mcp
+```
+
+## Notes
+This release focuses on version consistency and does not introduce any functional changes.

package/PUBLICATION_CONFIRMATION_V1.4.2.md

@@ -0,0 +1,16 @@
+# Publication Confirmation - Version 1.4.2
+
+This file confirms that version 1.4.2 of the @vint.tri/report_gen_mcp package has been prepared for publication.
+
+## Changes Made
+1. Updated version in package.json from 1.4.1 to 1.4.2
+2. Updated MCP server version in src/index.ts from 1.4.1 to 1.4.2
+3. Created VERSION_1.4.2_RELEASE_NOTES.md
+
+## Next Steps
+- Build the project with `npm run build`
+- Publish to npm with `npm publish`
+
+Once published, this version will be available for installation via:
+```bash
+npm install @vint.tri/report_gen_mcp@1.4.2

package/UPDATED_NEURAL_NETWORK_INSTRUCTIONS.md

@@ -64,7 +64,8 @@
 
 1. **Путь к файлу**: Абсолютный путь к созданному отчету
 2. **Ссылка на файл**: Кликабельная file:// ссылка для открытия отчета в браузере
-3. **Содержимое файла**: Полный текст HTML содержимого отчета
+3. **HTTP ссылка**: Если сервер запущен, ссылка вида http://localhost:3000/report/filename.html для доступа к отчету через веб-интерфейс
+4. **Содержимое файла**: Полный текст HTML содержимого отчета
 
 Обязательно покажите пользователю содержимое файла, чтобы он мог сразу ознакомиться с результатом без необходимости открывать файл отдельно.
 
@@ -76,6 +77,7 @@
 
 📁 Путь к файлу: /полный/путь/к/отчету.html
 🌐 Ссылка для открытия в браузере: file:///полный/путь/к/отчету.html
+🔗 HTTP ссылка: http://localhost:3000/report/отчет.html
 
 📄 Содержимое отчета:
 <!DOCTYPE html>
@@ -204,6 +206,28 @@
 }
 ```
 
+### 3. Особенности работы с изображениями
+
+При генерации изображений с помощью инструментов `generate_image` или `generate_image_to_file`, нейросеть должна:
+
+1. **При использовании `generate_image_to_file`** - всегда возвращать пользователю:
+   - Путь к файлу изображения на диске
+   - HTTP ссылку для доступа к изображению через веб-сервер (если сервер запущен): `http://localhost:3000/reports/имя_файла.jpg`
+   - File URL для открытия в браузере: `file:///полный/путь/к/файлу.jpg`
+
+2. **Пример корректного ответа при генерации изображения**:
+```
+✅ Изображение успешно сгенерировано!
+
+📁 Путь к файлу: /полный/путь/к/lizard_wedding_bitter.jpg
+🌐 Ссылка для открытия в браузере: file:///полный/путь/к/lizard_wedding_bitter.jpg
+🔗 HTTP ссылка: http://localhost:3000/reports/lizard_wedding_bitter.jpg
+
+Вы можете открыть изображение, кликнув на ссылку выше или скопировав путь к файлу.
+```
+
+3. **Автоматическая вставка изображений** - когда нейросеть получает ответ с информацией о сгенерированном изображении, она должна автоматически вставлять изображение в свой ответ пользователю по HTTP ссылке, если она доступна.
+
 ## Формат данных для диаграмм (графиков)
 
 Очень важно правильно формировать данные для диаграмм, чтобы избежать ошибок. Ниже приведены точные требования к формату данных для каждого типа диаграмм.
@@ -522,6 +546,7 @@
 
 📁 Путь к файлу: /path/to/report.html
 🌐 Ссылка для открытия в браузере: file:///path/to/report.html
+🔗 HTTP ссылка: http://localhost:3000/report/report.html
 
 Содержимое отчета:
 <!DOCTYPE html>

package/VERSION_1.4.1_RELEASE_NOTES.md

@@ -0,0 +1,18 @@
+# Version 1.4.1 Release Notes
+
+## Overview
+This is a minor release that updates the package version to 1.4.1. The primary purpose of this release is to ensure version consistency between the package.json and the MCP server configuration in the source code.
+
+## Changes
+- Updated package version from 1.4.0 to 1.4.1 in package.json
+- Updated MCP server version from 1.4.0 to 1.4.1 in src/index.ts
+- Rebuilt distribution files with the updated version information
+
+## Files Modified
+- package.json
+- src/index.ts (MCP server version update)
+
+## Impact
+This release ensures that the version information is consistent across all parts of the application, which is important for proper identification and debugging.
+
+No functional changes were introduced in this release.

package/VERSION_1.4.2_RELEASE_NOTES.md

@@ -0,0 +1,14 @@
+# Version 1.4.2 Release Notes
+
+## Overview
+This release updates the package version to 1.4.2 and ensures consistency across all files.
+
+## Changes
+- Updated package version from 1.4.1 to 1.4.2 in package.json
+- Updated MCP server version from 1.4.1 to 1.4.2 in src/index.ts
+
+## Files Modified
+- package.json
+- src/index.ts
+
+This is a minor version bump to align with the latest published version and maintain consistency in versioning.

package/dist/index.js

@@ -38,6 +38,10 @@ if (!isStdioMode) {
 const app = express();
 const port = 3000;
 app.use(express.json());
+// Serve static files from the reports directory at /report/ endpoint
+if (reportsDir) {
+    app.use('/report', express.static(reportsDir));
+}
 app.post('/generate-report', async (req, res) => {
     // For HTTP API mode, use the REPORTS_DIR environment variable
     // This endpoint only runs in non-stdio mode where reportsDir is guaranteed to be defined
@@ -103,7 +107,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.4.0",
+        version: "1.4.2",
     }, {
         // Disable health check to prevent automatic calls
         capabilities: {
@@ -263,8 +267,10 @@ if (process.argv.length === 2) {
                 fileUrl: fileUrl,
                 fileContent: fileContent
             };
+            // Generate HTTP link if server is running
+            const httpLink = reportsDir ? `http://localhost:${port}/report/${path.basename(outputPath)}` : null;
             // Return comprehensive information for neural network to use
-            // Neural network should present to user: file path, web link, and file content
+            // Neural network should present to user: file path, web link, HTTP link, and file content
             return {
                 content: [
                     {
@@ -274,8 +280,7 @@ if (process.argv.length === 2) {
 FOR THE NEURAL NETWORK: Please present the following information to the user:
 1. Path to file: ${outputPath}
 2. Web browser link: ${fileUrl}
-3. File content:
-${fileContent}`
+${httpLink ? `3. HTTP link: ${httpLink}\n4. File content:\n${fileContent}` : `3. File content:\n${fileContent}`}`
                     }
                 ]
             };
@@ -386,6 +391,8 @@ ${fileContent}`
             await fs.writeFile(filePath, fileContent, 'utf8');
             // Generate proper file URL
             const fileUrl = pathToFileURL(filePath).href;
+            // Generate HTTP link if server is running
+            const httpLink = reportsDir ? `http://localhost:${port}/report/${path.basename(filePath)}` : null;
             return {
                 content: [
                     {
@@ -395,7 +402,7 @@ ${fileContent}`
 FOR THE NEURAL NETWORK: Please present the following information to the user:
 1. Path to file: ${filePath}
 2. Web browser link: ${fileUrl}
-3. Operation performed: ${operation}`
+${httpLink ? `3. HTTP link: ${httpLink}\n4. Operation performed: ${operation}` : `3. Operation performed: ${operation}`}`
                     }
                 ]
             };
@@ -496,10 +503,12 @@ FOR THE NEURAL NETWORK: Please present the following information to the user:
             // Generate proper file URL
             const { pathToFileURL } = await import('url');
             const fileUrl = pathToFileURL(fullPath).href;
+            // Generate HTTP link if server is running
+            const httpLink = reportsDir ? `http://localhost:${port}/report/${path.basename(fullPath)}` : null;
             return {
                 content: [{
                         type: "text",
-                        text: `Image successfully generated!\n\nFile saved to: ${fullPath}\nWeb link: ${fileUrl}`
+                        text: `Image successfully generated!\n\nFile saved to: ${fullPath}\nWeb link: ${fileUrl}${httpLink ? `\nHTTP link: ${httpLink}` : ''}`
                     }]
             };
         }
@@ -599,10 +608,12 @@ FOR THE NEURAL NETWORK: Please present the following information to the user:
             // Создаем file URI для выходного файла
             const { pathToFileURL } = await import('url');
             const fileUrl = pathToFileURL(path.resolve(fullOutputPath)).href;
+            // Generate HTTP link if server is running
+            const httpLink = reportsDir ? `http://localhost:${port}/report/${path.basename(fullOutputPath)}` : null;
             return {
                 content: [{
                         type: "text",
-                        text: `Image successfully edited!\n\nOutput file: ${fullOutputPath}\nWeb link: ${fileUrl}`
+                        text: `Image successfully edited!\n\nOutput file: ${fullOutputPath}\nWeb link: ${fileUrl}${httpLink ? `\nHTTP link: ${httpLink}` : ''}`
                     }]
             };
         }

package/package.json

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