@imenam/mcp-documentor 1.0.52 → 1.0.53

package/dist/src/index.js

@@ -38,6 +38,7 @@ import { reindexEmbeddings } from "./tools/reindex-embeddings.js";
 import { prepareExportBundle } from "./tools/prepare-export-bundle.js";
 import { deleteExportBundle } from "./tools/delete-export-bundle.js";
 import { uploadImage } from "./tools/upload-image.js";
+import { getImage } from "./tools/get-image.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 function findProjectRoot(startDir) {
@@ -987,6 +988,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                     required: ["filename", "filePath"],
                 },
             },
+            {
+                name: "get_image",
+                description: "Retrieve an image stored in a project's assets by its URI and return it as a base64-encoded image. Use this when a document references an image (e.g. ![alt](/api/images/{project}/{filename})) and you need to view its content.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        uri: { type: "string", description: "Image URI as it appears in the document, e.g. '/api/images/my-project/screenshot.png'" },
+                    },
+                    required: ["uri"],
+                },
+            },
         ],
     };
 });
@@ -1058,6 +1070,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
             case "upload_image":
                 return await uploadImage(storageEngine, args);
+            case "get_image":
+                return await getImage(storageEngine, args);
             default:
                 throw new Error(`Tool not found: ${name}`);
         }

package/dist/src/tools/get-image.d.ts

@@ -0,0 +1,15 @@
+import type { StorageEngine } from "../core/storage-engine.js";
+export declare function getImage(storageEngine: StorageEngine, args: unknown): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+} | {
+    content: {
+        type: string;
+        data: string;
+        mimeType: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/src/tools/get-image.js

@@ -0,0 +1,67 @@
+import fs from "fs";
+import path from "path";
+import { z } from "zod";
+const GetImageArgsSchema = z.object({
+    uri: z.string().min(1),
+});
+const MIME_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+    ".bmp": "image/bmp",
+    ".ico": "image/x-icon",
+};
+export async function getImage(storageEngine, args) {
+    try {
+        const validated = GetImageArgsSchema.parse(args);
+        // Expected URI format: /api/images/{project}/{filename}
+        const match = validated.uri.match(/^\/api\/images\/([^/]+)\/([^/]+)$/);
+        if (!match) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid image URI format. Expected: /api/images/{project}/{filename}. Got: ${validated.uri}`,
+                    },
+                ],
+            };
+        }
+        const project = decodeURIComponent(match[1]);
+        const filename = decodeURIComponent(match[2]);
+        const assetsDir = path.join(storageEngine.getDataDir(), "projects", project, "assets");
+        const filePath = path.join(assetsDir, filename);
+        // Prevent path traversal
+        if (!filePath.startsWith(assetsDir)) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "Invalid image path." }],
+            };
+        }
+        if (!fs.existsSync(filePath)) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Image not found: ${validated.uri}` }],
+            };
+        }
+        const ext = path.extname(filename).toLowerCase();
+        const mimeType = MIME_TYPES[ext] ?? "application/octet-stream";
+        const data = fs.readFileSync(filePath).toString("base64");
+        return {
+            content: [
+                {
+                    type: "image",
+                    data,
+                    mimeType,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { isError: true, content: [{ type: "text", text: `Error retrieving image: ${message}` }] };
+    }
+}

package/dist/src/version.d.ts

@@ -1 +1 @@
-export declare const APP_VERSION = "1.0.52";
+export declare const APP_VERSION = "1.0.53";

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated version file - do not edit manually
-export const APP_VERSION = '1.0.52';
+export const APP_VERSION = '1.0.53';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imenam/mcp-documentor",
-  "version": "1.0.52",
+  "version": "1.0.53",
   "main": "dist/src/index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",