EverArt Forge MCP Server

Instructions

Implementation Reference

• src/index.ts:793-879 (handler)

  The handler for the 'view_image' tool. It takes a filename argument, constructs the full path using STORAGE_DIR, verifies the file exists, reads it for potential inline display, opens the image in the system's default viewer using the 'open' library, and returns a success message with the file path.
  case "view_image": { try { const args = request.params.arguments as any; // Validate filename if (!args.filename || typeof args.filename !== 'string') { return errorResponse({ type: EverArtErrorType.VALIDATION_ERROR, message: "filename is required and must be a string" }); } const filename = args.filename; const filepath = path.join(STORAGE_DIR, filename); try { // Check if file exists await fs.access(filepath); } catch (accessError) { // List available files to help the user const availableFiles = await listStoredImages(); let errorMsg = `Image not found: ${filename}`; if (availableFiles.length > 0) { const suggestions = availableFiles .filter(f => f.toLowerCase().includes(filename.toLowerCase()) || filename.toLowerCase().includes(f.toLowerCase().split('_').pop() || '')) .slice(0, 3); if (suggestions.length > 0) { errorMsg += `\n\nDid you mean one of these?\n` + suggestions.map(s => `• ${s}`).join('\n'); } errorMsg += `\n\nUse 'list_images' to see all available images.`; } return errorResponse({ type: EverArtErrorType.VALIDATION_ERROR, message: errorMsg }); } // Read the image for inline display let imageData: string | undefined; let mimeType: string = 'application/octet-stream'; try { const content = await fs.readFile(filepath); imageData = content.toString('base64'); const ext = path.extname(filename).slice(1).toLowerCase(); mimeType = getMimeType(ext); } catch (error) { console.warn("Unable to read image for inline display:", error); // Continue without inline display if reading fails } await open(filepath); // Skip opening in external viewer since we'll show in MCP try { // If we got here, cancel the auto-open to avoid duplicate windows // await open(filepath); } catch (openError) { // Ignore error } return { content: [ { type: "text", text: `✅ Viewing image: ${filename}` }, { type: "text", text: `Image opened in default viewer.\nFile path: file://${filepath}` } ], }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : "Unknown error"; return errorResponse({ type: EverArtErrorType.UNKNOWN_ERROR, message: `Error viewing image: ${errorMessage}` }); } }
• src/index.ts:427-440 (registration)

  Tool registration in the ListToolsRequestSchema handler, including the tool's name, description, and input schema definition.
  { name: "view_image", description: "Open a stored image in the default image viewer", inputSchema: { type: "object", properties: { filename: { type: "string", description: "Name of the image file to view", }, }, required: ["filename"], }, },
• src/index.ts:430-439 (schema)

  Input schema for the 'view_image' tool, specifying a required 'filename' string parameter.
  inputSchema: { type: "object", properties: { filename: { type: "string", description: "Name of the image file to view", }, }, required: ["filename"], },