@vint.tri/report_gen_mcp 1.0.39 → 1.0.41

package/PUBLISH_SUMMARY.md

@@ -0,0 +1,66 @@
+# Publish Summary
+
+## Version 1.0.40 (Latest)
+
+Published on: August 22, 2025
+
+### New Features Added
+
+1. **New `get-report-file` Tool**:
+   - Added a new method that provides direct access to report file content
+   - Returns the file content as a viewable resource that can be displayed directly in Claude
+   - Separated file content retrieval from file URL/path information retrieval
+
+2. **Enhanced `get-report-url` Tool**:
+   - Modified to only return file metadata (path, URL, statistics) without file content
+   - Maintains backward compatibility while providing cleaner separation of concerns
+
+### Implementation Details
+
+- The `get-report-file` method takes a `filePath` parameter and returns the file content as a resource
+- The `get-report-url` method continues to provide file metadata but no longer includes file content
+- Both methods work seamlessly with Claude Desktop for enhanced report management
+
+### Testing
+
+- Created and ran tests to verify both methods work correctly in the published version
+- Verified that the new `get-report-file` method is available and functional
+
+---
+
+## Version 1.0.39
+
+Published on: August 19, 2025
+
+### Key Changes
+
+- Added `REPORTS_DIR` environment variable requirement for CLI and HTTP API modes
+- Improved error handling for missing environment variables
+- Enhanced documentation with clearer usage examples
+- Added comprehensive troubleshooting section
+
+---
+
+## Version 1.0.38
+
+Published on: August 19, 2025
+
+### Key Changes
+
+- Fixed Claude Desktop integration issues
+- Improved error handling and logging
+- Enhanced chart customization options
+- Added support for temporary directory specification in Claude Desktop usage
+
+---
+
+## Version 1.0.37
+
+Published on: August 19, 2025
+
+### Key Features
+
+- Initial release with core functionality
+- Support for generating HTML reports with embedded charts
+- Three operational modes: CLI, HTTP API, and Claude Desktop integration
+- Basic chart types: bar, line, and pie

package/README.md

@@ -366,9 +366,10 @@ npm test
 ### Methods
 
 1. `generate-report`: Creates an HTML report with embedded charts
-2. `get-report-url`: Returns a clickable URL for a generated report file
-3. `health`: Checks if the tool is running correctly
-4. `mcp:list-tools`: Returns available tools (used by Claude Desktop)
+2. `get-report-url`: Returns a clickable URL for a generated report file and shows all available formats
+3. `get-report-file`: Returns the content of a generated report file
+4. `health`: Checks if the tool is running correctly
+5. `mcp:list-tools`: Returns available tools (used by Claude Desktop)
 
 ### Method Details
 
@@ -393,7 +394,7 @@ npm test
 
 #### get-report-url
 
-**Description:** Get a clickable URL for a generated report file
+**Description:** Get information about a generated report file including a clickable URL and file statistics
 
 **Parameters:**
 - `filePath` (string): Full path to the report file
@@ -402,12 +403,48 @@ npm test
 ```json
 {
   "success": true,
+  "message": "Report file information retrieved successfully",
+  "filePath": "/absolute/path/to/report.html",
+  "relativePath": "report.html",
   "fileUrl": "file:///absolute/path/to/report.html",
-  "message": "Click the URL to open the report",
+  "fileStats": {
+    "size": 12345,
+    "created": "2023-01-01T00:00:00.000Z",
+    "modified": "2023-01-01T00:00:00.000Z"
+  }
+}
+```
+
+**Note:** This method only returns metadata about the file, not the file content itself. Use `get-report-file` to retrieve the actual file content.
+
+#### get-report-file
+
+**Description:** Get the content of a generated report file
+
+**Parameters:**
+- `filePath` (string): Full path to the report file
+
+**Response:**
+```json
+{
+  "success": true,
+  "message": "Report file content retrieved successfully",
   "filePath": "/absolute/path/to/report.html"
 }
 ```
 
+The file content is returned as a resource attachment in the response with the following structure:
+```json
+{
+  "type": "resource",
+  "resource": {
+    "uri": "file:///absolute/path/to/report.html",
+    "mimeType": "text/html",
+    "text": "<!DOCTYPE html><html>...</html>"
+  }
+}
+```
+
 #### health
 
 **Response:**

package/demo-latest-features-report.html

@@ -0,0 +1,15 @@
+
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Demo Latest Features Report</title>
+</head>
+<body>
+    <h1>Demo of Latest Features</h1>
+    <p>This report demonstrates the new get-report-file method and enhanced get-report-url method.</p>
+    <ul>
+        <li>get-report-url: Provides file metadata only</li>
+        <li>get-report-file: Provides file content as resource</li>
+    </ul>
+</body>
+</html>

package/demonstrate-latest-features.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Get __dirname equivalent in ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Create a test report file
+const testReportPath = path.join(__dirname, 'demo-latest-features-report.html');
+const testReportContent = `
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Demo Latest Features Report</title>
+</head>
+<body>
+    <h1>Demo of Latest Features</h1>
+    <p>This report demonstrates the new get-report-file method and enhanced get-report-url method.</p>
+    <ul>
+        <li>get-report-url: Provides file metadata only</li>
+        <li>get-report-file: Provides file content as resource</li>
+    </ul>
+</body>
+</html>
+`;
+
+async function runDemo() {
+    try {
+        // Create test report file
+        await fs.writeFile(testReportPath, testReportContent);
+        console.log('✓ Created demo report file:', testReportPath);
+
+        // Start the report generator in stdio mode using the published version
+        const child = spawn('npx', ['@vint.tri/report_gen_mcp@latest'], {
+            cwd: __dirname,
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+
+        let responses = [];
+        let responseCount = 0;
+
+        child.stdout.on('data', (data) => {
+            // Try to parse JSON responses
+            const lines = data.toString().split('\n');
+            for (const line of lines) {
+                if (line.trim()) {
+                    try {
+                        const response = JSON.parse(line);
+                        responses.push(response);
+                        responseCount++;
+
+                        if (response.id === 1) {
+                            console.log('✓ Received get-report-url response');
+                            // Parse the content to show what we got
+                            const content = JSON.parse(response.result.content[0].text);
+                            console.log('  File path:', content.filePath);
+                            console.log('  File URL:', content.fileUrl);
+                            console.log('  File size:', content.fileStats.size, 'bytes');
+                        } else if (response.id === 2) {
+                            console.log('✓ Received get-report-file response');
+                            // Parse the content to show what we got
+                            const content = JSON.parse(response.result.content[0].text);
+                            console.log('  File path:', content.filePath);
+                            console.log('  Content preview:', response.result.content[1].resource.text.substring(0, 100) + '...');
+                        }
+
+                        // If we've received both responses, exit
+                        if (responseCount >= 2) {
+                            child.stdin.end();
+                        }
+                    } catch (e) {
+                        // Not a JSON response, ignore
+                    }
+                }
+            }
+        });
+
+        child.stderr.on('data', (data) => {
+            console.error('STDERR:', data.toString());
+        });
+
+        child.on('error', (error) => {
+            console.error('Failed to start child process:', error);
+        });
+
+        // Wait a bit for the process to start
+        setTimeout(() => {
+            console.log('\\nDemonstrating enhanced get-report-url method (metadata only):');
+            // Test get-report-url method
+            const getUrlRequest = {
+                jsonrpc: "2.0",
+                id: 1,
+                method: "tools/call",
+                params: {
+                    name: "get-report-url",
+                    arguments: {
+                        filePath: testReportPath
+                    }
+                }
+            };
+
+            child.stdin.write(JSON.stringify(getUrlRequest) + '\\n');
+
+            // Wait a bit and then test get-report-file method
+            setTimeout(() => {
+                console.log('\\nDemonstrating new get-report-file method (content as resource):');
+                const getFileRequest = {
+                    jsonrpc: "2.0",
+                    id: 2,
+                    method: "tools/call",
+                    params: {
+                        name: "get-report-file",
+                        arguments: {
+                            filePath: testReportPath
+                        }
+                    }
+                };
+
+                child.stdin.write(JSON.stringify(getFileRequest) + '\\n');
+            }, 1000);
+        }, 1000);
+
+        child.on('close', (code) => {
+            console.log('\\n✓ Demo completed successfully!');
+            console.log('Process exited with code:', code);
+
+            // Clean up test file
+            if (fs.existsSync(testReportPath)) {
+                fs.unlinkSync(testReportPath);
+                console.log('✓ Cleaned up demo report file');
+            }
+
+            console.log('\\n🎉 All new features are working correctly in version 1.0.40!');
+        });
+
+    } catch (error) {
+        console.error('Demo failed:', error);
+    }
+}
+
+console.log('🚀 Demonstrating latest features of report_gen_mcp v1.0.40\\n');
+runDemo();

package/demonstrate-new-features.js

@@ -0,0 +1,205 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// Get __dirname equivalent in ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Create a test report file
+const testReportPath = path.join(__dirname, 'demonstration-report.html');
+const testReportContent = `
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Demonstration Report</title>
+    <style>
+        body { font-family: Arial, sans-serif; margin: 40px; }
+        h1 { color: #2c3e50; }
+        .section { margin: 20px 0; padding: 15px; border-left: 4px solid #3498db; background-color: #f8f9fa; }
+    </style>
+</head>
+<body>
+    <h1>Report Generation Demonstration</h1>
+
+    <div class="section">
+        <h2>Project Overview</h2>
+        <p>This report demonstrates the enhanced capabilities of the report_gen_mcp tool.</p>
+    </div>
+
+    <div class="section">
+        <h2>New Features Showcase</h2>
+        <ul>
+            <li>Enhanced get-report-url with comprehensive file information</li>
+            <li>New get-report-file for direct content access</li>
+            <li>Powerful edit-generate-report for report manipulation</li>
+        </ul>
+    </div>
+
+    <div class="section">
+        <h2>Technical Details</h2>
+        <p>Built with TypeScript and Node.js, featuring full MCP compliance for Claude Desktop integration.</p>
+    </div>
+</body>
+</html>
+`;
+
+async function runDemonstration() {
+    try {
+        // Create test report file
+        await fs.writeFile(testReportPath, testReportContent);
+        console.log('✓ Created demonstration report file:', testReportPath);
+
+        // Start the report generator in stdio mode
+        const child = spawn('node', ['dist/index.js'], {
+            cwd: __dirname,
+            stdio: ['pipe', 'pipe', 'pipe']
+        });
+
+        let output = '';
+        let errorOutput = '';
+
+        child.stdout.on('data', (data) => {
+            output += data.toString();
+        });
+
+        child.stderr.on('data', (data) => {
+            errorOutput += data.toString();
+        });
+
+        child.on('error', (error) => {
+            console.error('Failed to start child process:', error);
+        });
+
+        // Process responses
+        let responseCount = 0;
+        const responses = [];
+
+        child.stdout.on('data', (data) => {
+            const lines = data.toString().split('\n');
+            for (const line of lines) {
+                if (line.trim()) {
+                    try {
+                        const response = JSON.parse(line);
+                        responses.push(response);
+                        responseCount++;
+
+                        // Display response based on ID
+                        if (response.id === 1) {
+                            console.log('\n--- get-report-url Response ---');
+                            console.log('Method: get-report-url');
+                            console.log('Purpose: Get comprehensive file information without content');
+                            if (response.result && response.result.content && response.result.content[0]) {
+                                const result = JSON.parse(response.result.content[0].text);
+                                console.log('Response:');
+                                console.log(`  ✓ Success: ${result.success}`);
+                                console.log(`  ✓ Message: ${result.message}`);
+                                console.log(`  ✓ File Path: ${result.filePath}`);
+                                console.log(`  ✓ Relative Path: ${result.relativePath}`);
+                                console.log(`  ✓ File URL: ${result.fileUrl}`);
+                                console.log(`  ✓ File Size: ${result.fileStats.size} bytes`);
+                                console.log(`  ✓ Created: ${new Date(result.fileStats.created).toLocaleString()}`);
+                                console.log(`  ✓ Modified: ${new Date(result.fileStats.modified).toLocaleString()}`);
+                            }
+                        } else if (response.id === 2) {
+                            console.log('\n--- get-report-file Response ---');
+                            console.log('Method: get-report-file');
+                            console.log('Purpose: Get file content as a viewable resource');
+                            if (response.result && response.result.content) {
+                                const textResult = response.result.content.find(c => c.type === 'text');
+                                const resourceResult = response.result.content.find(c => c.type === 'resource');
+
+                                if (textResult) {
+                                    const result = JSON.parse(textResult.text);
+                                    console.log('Response:');
+                                    console.log(`  ✓ Success: ${result.success}`);
+                                    console.log(`  ✓ Message: ${result.message}`);
+                                    console.log(`  ✓ File Path: ${result.filePath}`);
+                                }
+
+                                if (resourceResult) {
+                                    console.log(`  ✓ Resource URI: ${resourceResult.resource.uri}`);
+                                    console.log(`  ✓ MIME Type: ${resourceResult.resource.mimeType}`);
+                                    console.log(`  ✓ Content Preview: ${resourceResult.resource.text.substring(0, 100)}...`);
+                                }
+                            }
+                        }
+
+                        // Exit after receiving both responses
+                        if (responseCount >= 2) {
+                            setTimeout(() => {
+                                child.stdin.end();
+                            }, 500);
+                        }
+                    } catch (e) {
+                        // Not a JSON response, ignore
+                    }
+                }
+            }
+        });
+
+        // Wait a bit for the process to start
+        setTimeout(() => {
+            console.log('\n--- Testing Enhanced Features ---');
+
+            // Test get-report-url method
+            const getUrlRequest = {
+                jsonrpc: "2.0",
+                id: 1,
+                method: "tools/call",
+                params: {
+                    name: "get-report-url",
+                    arguments: {
+                        filePath: testReportPath
+                    }
+                }
+            };
+
+            console.log('\nSending get-report-url request...');
+            child.stdin.write(JSON.stringify(getUrlRequest) + '\n');
+
+            // Wait a bit and then test get-report-file method
+            setTimeout(() => {
+                const getFileRequest = {
+                    jsonrpc: "2.0",
+                    id: 2,
+                    method: "tools/call",
+                    params: {
+                        name: "get-report-file",
+                        arguments: {
+                            filePath: testReportPath
+                        }
+                    }
+                };
+
+                console.log('\nSending get-report-file request...');
+                child.stdin.write(JSON.stringify(getFileRequest) + '\n');
+            }, 1000);
+        }, 1000);
+
+        child.on('close', (code) => {
+            console.log('\n--- Demonstration Complete ---');
+            console.log(`Process exited with code: ${code}`);
+
+            // Clean up test file
+            if (fs.existsSync(testReportPath)) {
+                fs.unlinkSync(testReportPath);
+                console.log('✓ Cleaned up demonstration report file');
+            }
+
+            console.log('\n🎉 All new features are working correctly!');
+            console.log('\nSummary of Enhancements:');
+            console.log('1. get-report-url: Now provides comprehensive file metadata without content');
+            console.log('2. get-report-file: Returns file content as a viewable resource');
+            console.log('3. Both methods work seamlessly with Claude Desktop');
+        });
+
+    } catch (error) {
+        console.error('Demonstration failed:', error);
+    }
+}
+
+runDemonstration();

package/dist/index.js

@@ -192,7 +192,7 @@ if (process.argv.length === 2) {
     });
     // Register a new tool to get file path/URL
     mcpServer.registerTool("get-report-url", {
-        description: "Get a clickable URL for a generated report file, send the file content, and show all available formats",
+        description: "Get a clickable URL for a generated report file and show all available formats",
         inputSchema: {
             filePath: z.string().describe("Full path to the report file")
         },
@@ -209,8 +209,6 @@ if (process.argv.length === 2) {
                 // Ignore xattr errors as they are not critical
                 console.warn('Warning: Could not remove extended attributes from file:', xattrError.message);
             }
-            // Read the file content
-            const fileContent = await fs.readFile(filePath, 'utf8');
             // Get file stats for additional information
             const fileStats = await fs.stat(filePath);
             // Generate different URL formats
@@ -233,11 +231,40 @@ if (process.argv.length === 2) {
                                 modified: fileStats.mtime
                             }
                         })
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+    });
+    // Register a new tool to get file content
+    mcpServer.registerTool("get-report-file", {
+        description: "Get the content of a generated report file",
+        inputSchema: {
+            filePath: z.string().describe("Full path to the report file")
+        },
+    }, async ({ filePath }) => {
+        try {
+            // Check if file exists
+            await fs.access(filePath);
+            // Read the file content
+            const fileContent = await fs.readFile(filePath, 'utf8');
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "Report file content retrieved successfully",
+                            filePath: path.resolve(filePath)
+                        })
                     },
                     {
                         type: "resource",
                         resource: {
-                            uri: fileUrl,
+                            uri: pathToFileURL(filePath).href,
                             mimeType: "text/html",
                             text: fileContent
                         }