read-email-mcp 1.0.0

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "read-email-mcp",
+  "version": "1.0.0",
+  "description": "Read-only MCP server that mirrors any IMAP mailbox into a local SQLite copy for browsing and searching email.",
+  "license": "MIT",
+  "author": "KelpHect",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KelpHect/read-email-mcp.git"
+  },
+  "homepage": "https://github.com/KelpHect/read-email-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/KelpHect/read-email-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "imap",
+    "email",
+    "sqlite",
+    "read-email"
+  ],
+  "type": "module",
+  "bin": {
+    "read-email-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "smoke:mcp": "node scripts/smoke-mcp.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "verify": "npm test && npm run typecheck && npm run build && npm run smoke:mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.4.6",
+    "imapflow": "^1.0.191",
+    "mailparser": "^3.7.5",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/mailparser": "^3.4.6",
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.14"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/scripts/smoke-mcp.mjs

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const expectedTools = [
+  "browse_email_dates",
+  "get_email",
+  "get_raw_email",
+  "get_recent_emails",
+  "get_storage_stats",
+  "get_sync_status",
+  "get_thread",
+  "list_emails",
+  "list_mailboxes",
+  "optimize_email_store",
+  "search_emails",
+  "sync_email"
+];
+
+const inheritedEnv = Object.fromEntries(Object.entries(process.env).filter(([, value]) => value !== undefined));
+delete inheritedEnv.EMAIL;
+delete inheritedEnv.PASSWORD;
+delete inheritedEnv.IMAP_HOST;
+delete inheritedEnv.IMAP_PORT;
+delete inheritedEnv.IMAP_SECURE;
+delete inheritedEnv.IMAP_USER;
+const transport = new StdioClientTransport({
+  command: process.execPath,
+  args: [
+    path.join(root, "dist", "index.js"),
+    "--email",
+    "smoke@example.com",
+    "--password",
+    "dummy-password",
+    "--imap-host",
+    "imap.example.com"
+  ],
+  cwd: root,
+  env: inheritedEnv,
+  stderr: "pipe"
+});
+
+const stderr = [];
+transport.stderr?.on("data", (chunk) => stderr.push(String(chunk)));
+
+const client = new Client(
+  {
+    name: "read-email-mcp-smoke",
+    version: "1.0.0-rc.1"
+  },
+  {
+    capabilities: {}
+  }
+);
+
+try {
+  await client.connect(transport);
+  const result = await client.listTools();
+  const actualTools = result.tools.map((tool) => tool.name).sort();
+  const missing = expectedTools.filter((tool) => !actualTools.includes(tool));
+  const extra = actualTools.filter((tool) => !expectedTools.includes(tool));
+  const stderrText = stderr.join("").trim();
+
+  if (missing.length || extra.length) {
+    throw new Error(
+      `Tool list mismatch. Missing: ${missing.join(", ") || "none"}. Extra: ${extra.join(", ") || "none"}.`
+    );
+  }
+
+  if (stderrText) {
+    throw new Error(`Server wrote to stderr during smoke test: ${stderrText}`);
+  }
+
+  console.log(`MCP smoke passed: ${actualTools.length} tools exposed.`);
+} finally {
+  await client.close();
+}