@kononenko-e/email-mcp 0.2.3

package/dist/connections/manager.js

@@ -0,0 +1,272 @@
+/**
+ * Connection manager for lazy-persistent IMAP and SMTP connections.
+ *
+ * - Creates connections on first use per account
+ * - Reuses open connections across tool calls
+ * - Auto-reconnects on failure
+ * - Graceful shutdown closes all connections
+ */
+import { ImapFlow } from 'imapflow';
+import nodemailer from 'nodemailer';
+import { mcpLog } from '../logging.js';
+export default class ConnectionManager {
+    imapClients = new Map();
+    smtpTransports = new Map();
+    accounts = new Map();
+    oauthService;
+    constructor(accounts, oauthService) {
+        accounts.forEach((account) => {
+            this.accounts.set(account.name, account);
+        });
+        this.oauthService = oauthService;
+    }
+    // -------------------------------------------------------------------------
+    // Account lookup
+    // -------------------------------------------------------------------------
+    getAccount(name) {
+        const account = this.accounts.get(name);
+        if (!account) {
+            throw new Error(`Account "${name}" not found. Available: ${[...this.accounts.keys()].join(', ')}`);
+        }
+        return account;
+    }
+    getAccountNames() {
+        return [...this.accounts.keys()];
+    }
+    setAccounts(accounts) {
+        this.accounts.clear();
+        accounts.forEach((account) => {
+            this.accounts.set(account.name, account);
+        });
+    }
+    // -------------------------------------------------------------------------
+    // IMAP
+    // -------------------------------------------------------------------------
+    async getImapClient(accountName) {
+        const existing = this.imapClients.get(accountName);
+        if (existing?.usable) {
+            return existing;
+        }
+        // Clean up stale connection
+        if (existing) {
+            this.imapClients.delete(accountName);
+            try {
+                existing.close();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        const account = this.getAccount(accountName);
+        // Build auth config based on auth type
+        let auth;
+        if (account.oauth2 && this.oauthService) {
+            const accessToken = await this.oauthService.getAccessToken(account.oauth2);
+            auth = { user: account.username, accessToken };
+        }
+        else {
+            auth = { user: account.username, pass: account.password };
+        }
+        const client = new ImapFlow({
+            host: account.imap.host,
+            port: account.imap.port,
+            secure: account.imap.tls,
+            tls: {
+                rejectUnauthorized: account.imap.verifySsl,
+            },
+            auth,
+            logger: false,
+        });
+        await client.connect();
+        await mcpLog('info', 'imap', `Connected to ${account.imap.host}:${account.imap.port} for "${accountName}"`);
+        this.imapClients.set(accountName, client);
+        return client;
+    }
+    // -------------------------------------------------------------------------
+    // SMTP
+    // -------------------------------------------------------------------------
+    static buildSmtpTransportOptions(account, auth) {
+        const pool = account.smtp.pool ?? {
+            enabled: true,
+            maxConnections: 1,
+            maxMessages: 100,
+        };
+        return {
+            host: account.smtp.host,
+            port: account.smtp.port,
+            secure: account.smtp.tls,
+            requireTLS: account.smtp.starttls,
+            ignoreTLS: !account.smtp.tls && !account.smtp.starttls,
+            tls: {
+                rejectUnauthorized: account.smtp.verifySsl,
+            },
+            auth,
+            pool: pool.enabled,
+            ...(pool.enabled
+                ? {
+                    maxConnections: pool.maxConnections,
+                    maxMessages: pool.maxMessages,
+                }
+                : {}),
+        };
+    }
+    async getSmtpTransport(accountName, options) {
+        const verify = options?.verify ?? false;
+        const existing = this.smtpTransports.get(accountName);
+        if (existing) {
+            if (!verify) {
+                return existing;
+            }
+            try {
+                await existing.verify();
+                return existing;
+            }
+            catch {
+                this.smtpTransports.delete(accountName);
+                try {
+                    existing.close();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        const account = this.getAccount(accountName);
+        // Build auth config based on auth type
+        let auth;
+        if (account.oauth2 && this.oauthService) {
+            const accessToken = await this.oauthService.getAccessToken(account.oauth2);
+            auth = { type: 'OAuth2', user: account.username, accessToken };
+        }
+        else {
+            auth = { user: account.username, pass: account.password };
+        }
+        const transport = nodemailer.createTransport(ConnectionManager.buildSmtpTransportOptions(account, auth));
+        await transport.verify();
+        await mcpLog('info', 'smtp', `Connected to ${account.smtp.host}:${account.smtp.port} for "${accountName}"`);
+        this.smtpTransports.set(accountName, transport);
+        return transport;
+    }
+    async verifySmtpTransport(accountName) {
+        await this.getSmtpTransport(accountName, { verify: true });
+    }
+    // -------------------------------------------------------------------------
+    // Test connections (for setup wizard / test command)
+    // -------------------------------------------------------------------------
+    static async testImap(account, oauthService) {
+        let client;
+        try {
+            let auth;
+            if (account.oauth2 && oauthService) {
+                const accessToken = await oauthService.getAccessToken(account.oauth2);
+                auth = { user: account.username, accessToken };
+            }
+            else {
+                auth = { user: account.username, pass: account.password };
+            }
+            client = new ImapFlow({
+                host: account.imap.host,
+                port: account.imap.port,
+                secure: account.imap.tls,
+                tls: {
+                    rejectUnauthorized: account.imap.verifySsl,
+                },
+                auth,
+                logger: false,
+            });
+            await client.connect();
+            const mailboxes = await client.list();
+            let messageCount = 0;
+            try {
+                const inbox = await client.status('INBOX', {
+                    messages: true,
+                    unseen: true,
+                });
+                messageCount = inbox.messages ?? 0;
+            }
+            catch {
+                // INBOX may not exist (e.g. Google Workspace uses "All Mail")
+                if (mailboxes.length > 0) {
+                    try {
+                        const first = await client.status(mailboxes[0].path, {
+                            messages: true,
+                        });
+                        messageCount = first.messages ?? 0;
+                    }
+                    catch {
+                        /* ignore — connection still works */
+                    }
+                }
+            }
+            return {
+                success: true,
+                details: {
+                    messages: messageCount,
+                    folders: mailboxes.length,
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+        finally {
+            if (client) {
+                try {
+                    await client.logout();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+    }
+    static async testSmtp(account, oauthService) {
+        let transport;
+        try {
+            let auth;
+            if (account.oauth2 && oauthService) {
+                const accessToken = await oauthService.getAccessToken(account.oauth2);
+                auth = { type: 'OAuth2', user: account.username, accessToken };
+            }
+            else {
+                auth = { user: account.username, pass: account.password };
+            }
+            transport = nodemailer.createTransport(ConnectionManager.buildSmtpTransportOptions(account, auth));
+            await transport.verify();
+            return { success: true };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+        finally {
+            transport?.close();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Shutdown
+    // -------------------------------------------------------------------------
+    async closeAll() {
+        await mcpLog('info', 'connections', 'Closing all connections');
+        const closeOps = [];
+        Array.from(this.imapClients.entries()).forEach(([name, client]) => {
+            closeOps.push(client
+                .logout()
+                .catch(() => { })
+                .then(() => {
+                this.imapClients.delete(name);
+            }));
+        });
+        Array.from(this.smtpTransports.entries()).forEach(([name, transport]) => {
+            transport.close();
+            this.smtpTransports.delete(name);
+        });
+        await Promise.allSettled(closeOps);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/connections/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/connections/manager.ts"],"names":[],"mappings":"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"}

package/dist/connections/types.d.ts

@@ -0,0 +1,13 @@
+import type { ImapFlow } from 'imapflow';
+import type { Transporter } from 'nodemailer';
+import type { AccountConfig } from '../types/index.js';
+export interface IConnectionManager {
+    getAccount: (name: string) => AccountConfig;
+    getAccountNames: () => string[];
+    getImapClient: (accountName: string) => Promise<ImapFlow>;
+    getSmtpTransport: (accountName: string, options?: {
+        verify?: boolean;
+    }) => Promise<Transporter>;
+    closeAll: () => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connections/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connections/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC;IAC5C,eAAe,EAAE,MAAM,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,gBAAgB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAChG,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}

package/dist/connections/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/connections/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connections/types.ts"],"names":[],"mappings":""}

package/dist/logging.d.ts

@@ -0,0 +1,46 @@
+/**
+ * MCP protocol logging bridge.
+ *
+ * Forwards structured log messages to the connected MCP client
+ * via the logging notification channel declared in server capabilities.
+ *
+ * Messages are silently dropped until `markInitialized()` is called,
+ * which should happen only after the MCP `initialized` handshake
+ * completes.  This prevents pre-handshake notifications from being
+ * written to stdout and breaking clients.
+ *
+ * Usage:
+ *   bindServer(server)       — call once after creating the McpServer
+ *   markInitialized()        — call from the `oninitialized` callback
+ *   mcpLog("info", …)        — fire-and-forget from anywhere
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
+/**
+ * Bind an McpServer instance so subsequent `mcpLog()` calls
+ * are forwarded to the connected client.
+ */
+export declare function bindServer(server: McpServer): void;
+/**
+ * Mark the server as fully initialized (handshake complete).
+ *
+ * Call this from the `server.server.oninitialized` callback so that
+ * `mcpLog()` starts forwarding messages to the client.
+ */
+export declare function markInitialized(): void;
+/**
+ * Reset module state.  **Test-only** — never call in production.
+ * @internal
+ */
+export declare function __resetForTesting(): void;
+/**
+ * Emit a structured log message over the MCP logging channel.
+ *
+ * Safe to call at any point — silently dropped when:
+ *   • the server hasn't been bound yet
+ *   • the transport isn't connected
+ *   • the MCP handshake hasn't completed (`markInitialized()` not called)
+ */
+export declare function mcpLog(level: LogLevel, logger: string, data: unknown): Promise<void>;
+export {};
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,KAAK,QAAQ,GACT,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAOhB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;GAGG;AAEH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1F"}

package/dist/logging.js

@@ -0,0 +1,63 @@
+/**
+ * MCP protocol logging bridge.
+ *
+ * Forwards structured log messages to the connected MCP client
+ * via the logging notification channel declared in server capabilities.
+ *
+ * Messages are silently dropped until `markInitialized()` is called,
+ * which should happen only after the MCP `initialized` handshake
+ * completes.  This prevents pre-handshake notifications from being
+ * written to stdout and breaking clients.
+ *
+ * Usage:
+ *   bindServer(server)       — call once after creating the McpServer
+ *   markInitialized()        — call from the `oninitialized` callback
+ *   mcpLog("info", …)        — fire-and-forget from anywhere
+ */
+let mcpServerRef = null;
+/** `true` only after the client has completed the MCP `initialized` handshake. */
+let initialized = false;
+/**
+ * Bind an McpServer instance so subsequent `mcpLog()` calls
+ * are forwarded to the connected client.
+ */
+export function bindServer(server) {
+    mcpServerRef = server;
+}
+/**
+ * Mark the server as fully initialized (handshake complete).
+ *
+ * Call this from the `server.server.oninitialized` callback so that
+ * `mcpLog()` starts forwarding messages to the client.
+ */
+export function markInitialized() {
+    initialized = true;
+}
+/**
+ * Reset module state.  **Test-only** — never call in production.
+ * @internal
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention, no-underscore-dangle
+export function __resetForTesting() {
+    mcpServerRef = null;
+    initialized = false;
+}
+/**
+ * Emit a structured log message over the MCP logging channel.
+ *
+ * Safe to call at any point — silently dropped when:
+ *   • the server hasn't been bound yet
+ *   • the transport isn't connected
+ *   • the MCP handshake hasn't completed (`markInitialized()` not called)
+ */
+export async function mcpLog(level, logger, data) {
+    if (!initialized || !mcpServerRef?.isConnected())
+        return;
+    try {
+        await mcpServerRef.sendLoggingMessage({ level, logger, data });
+    }
+    catch {
+        // Never let a logging failure break tool execution
+    }
+}
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAcH,IAAI,YAAY,GAAqB,IAAI,CAAC;AAE1C,kFAAkF;AAClF,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC1C,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,sFAAsF;AACtF,MAAM,UAAU,iBAAiB;IAC/B,YAAY,GAAG,IAAI,CAAC;IACpB,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAe,EAAE,MAAc,EAAE,IAAa;IACzE,IAAI,CAAC,WAAW,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE;QAAE,OAAO;IACzD,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;AACH,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Email MCP Server — Main entry point.
+ *
+ * Subcommands:
+ *   stdio     Run as MCP server over stdio (default)
+ *   http      Run as MCP server over Streamable HTTP (port 8080 by default)
+ *   setup     Interactive account setup wizard
+ *   test      Test IMAP/SMTP connections
+ *   config    Config management (show, path, init)
+ *   scheduler Email scheduling management
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}