fastmail-mcp-server 0.4.0 → 0.4.2

package/README.md

@@ -66,6 +66,16 @@ Token format: `fmu1-xxxxxxxx-xxxxxxxxxxxx...`
 
 ### 2. Configure Claude Desktop
 
+Install the server globally:
+
+```bash
+# Via mise (recommended)
+mise use -g npm:fastmail-mcp-server
+
+# Or via npm
+npm install -g fastmail-mcp-server
+```
+
 Open the Claude Desktop config file:
 
 ```bash
@@ -83,8 +93,7 @@ Add the fastmail server config:
 {
   "mcpServers": {
     "fastmail": {
-      "command": "bunx",
-      "args": ["-y", "fastmail-mcp-server"],
+      "command": "fastmail-mcp-server",
       "env": {
         "FASTMAIL_API_TOKEN": "fmu1-your-token-here"
       }
@@ -93,6 +102,8 @@ Add the fastmail server config:
 }
 ```
 
+> **Note:** If Claude Desktop can't find the command, use the full path from `which fastmail-mcp-server`
+
 ### 3. Restart Claude Desktop
 
 Quit Claude Desktop completely (Cmd+Q) and reopen it. The Fastmail tools should now appear.

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "fastmail-mcp-server",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "MCP server for Fastmail - read, search, and send emails via Claude",
   "type": "module",
   "main": "src/index.ts",
+  "bin": {
+    "fastmail-mcp-server": "src/index.ts"
+  },
   "files": [
     "src/**/*"
   ],
@@ -38,10 +41,12 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1",
     "officeparser": "^6.0.4",
+    "sharp": "^0.34.5",
     "zod": "^4.3.4"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "@types/sharp": "^0.32.0"
   }
 }

package/src/index.ts

@@ -5,6 +5,7 @@ import {
 } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { parseOffice } from "officeparser";
+import sharp from "sharp";
 import { z } from "zod";
 import {
 	buildForward,
@@ -810,25 +811,72 @@ server.tool(
 			}
 		}
 
-		const base64 = Buffer.from(result.data).toString("base64");
-
-		// Images - return as image content
+		// Images - return as image content (resize if >1MB for model limits)
 		if (result.type.startsWith("image/")) {
+			const MAX_SIZE = 1024 * 1024; // 1MB
+			let imageData = result.data;
+			let mimeType = result.type;
+			let resized = false;
+
+			if (result.data.byteLength > MAX_SIZE) {
+				try {
+					// Resize to fit under 1MB, convert to JPEG for better compression
+					let quality = 85;
+					let resizedBuffer = await sharp(result.data)
+						.resize({
+							width: 2048,
+							height: 2048,
+							fit: "inside",
+							withoutEnlargement: true,
+						})
+						.jpeg({ quality })
+						.toBuffer();
+
+					// If still too large, reduce quality progressively
+					while (resizedBuffer.byteLength > MAX_SIZE && quality > 30) {
+						quality -= 15;
+						resizedBuffer = await sharp(result.data)
+							.resize({
+								width: 1600,
+								height: 1600,
+								fit: "inside",
+								withoutEnlargement: true,
+							})
+							.jpeg({ quality })
+							.toBuffer();
+					}
+
+					imageData = resizedBuffer;
+					mimeType = "image/jpeg";
+					resized = true;
+				} catch (err) {
+					console.error(`[get_attachment] Image resize failed:`, err);
+					// Fall through with original
+				}
+			}
+
+			const base64 = Buffer.from(imageData).toString("base64");
+			const sizeInfo = resized
+				? `${Math.round(result.size / 1024)}KB → ${Math.round(imageData.byteLength / 1024)}KB resized`
+				: `${Math.round(result.size / 1024)}KB`;
+
 			return {
 				content: [
 					{
 						type: "text" as const,
-						text: `Attachment: ${result.name || "(unnamed)"} (${Math.round(result.size / 1024)}KB)`,
+						text: `Attachment: ${result.name || "(unnamed)"} (${sizeInfo})`,
 					},
 					{
 						type: "image" as const,
 						data: base64,
-						mimeType: result.type,
+						mimeType: mimeType,
 					},
 				],
 			};
 		}
 
+		const base64 = Buffer.from(result.data).toString("base64");
+
 		// Other binary - return base64 as last resort
 		return {
 			content: [