@bencibro/tempmail-mcp 0.0.1

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;IAExB,yCAAyC;IACzC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhC,6CAA6C;IAC7C,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEjE,8CAA8C;IAC9C,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE3D,iDAAiD;IACjD,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3E,uCAAuC;IACvC,aAAa,CAAC,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,iFAAiF;IACjF,YAAY,CACV,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for the temporary email service.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared utility functions.
+ */
+/**
+ * Generate a random alphanumeric string of the given length.
+ */
+export declare function randomString(length: number): string;
+/**
+ * Generate a random username (6-12 chars, always starts with a letter).
+ */
+export declare function randomUsername(): string;
+/**
+ * Sleep for the given milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Default wait-for-email options merged with user-provided overrides.
+ */
+export declare function mergeWaitOptions(options?: import("./types.js").WaitForEmailOptions): Required<import("./types.js").WaitForEmailOptions>;
+/**
+ * Check if a message matches the filter criteria.
+ */
+export declare function messageMatches(msg: import("./types.js").EmailMessage, subjectContains: string, fromContains: string): boolean;
+/**
+ * Extract verification code from an email body.
+ * Looks for common patterns: 4-8 digit codes, alphanumeric codes, etc.
+ */
+export declare function extractVerificationCode(msg: import("./types.js").EmailMessage): string | null;
+/**
+ * Strip HTML tags and return plain text.
+ */
+export declare function stripHtml(html: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,mBAAmB,GACjD,QAAQ,CAAC,OAAO,YAAY,EAAE,mBAAmB,CAAC,CAOpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,YAAY,EAAE,YAAY,EACtC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,YAAY,EAAE,YAAY,GACrC,MAAM,GAAG,IAAI,CAwBf;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa9C"}

package/dist/utils.js

@@ -0,0 +1,100 @@
+/**
+ * Shared utility functions.
+ */
+/**
+ * Generate a random alphanumeric string of the given length.
+ */
+export function randomString(length) {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    let result = "";
+    for (let i = 0; i < length; i++) {
+        result += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return result;
+}
+/**
+ * Generate a random username (6-12 chars, always starts with a letter).
+ */
+export function randomUsername() {
+    const letters = "abcdefghijklmnopqrstuvwxyz";
+    const start = letters[Math.floor(Math.random() * letters.length)];
+    return start + randomString(5 + Math.floor(Math.random() * 7));
+}
+/**
+ * Sleep for the given milliseconds.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Default wait-for-email options merged with user-provided overrides.
+ */
+export function mergeWaitOptions(options) {
+    return {
+        subjectContains: options?.subjectContains ?? "",
+        fromContains: options?.fromContains ?? "",
+        timeoutMs: options?.timeoutMs ?? 60_000,
+        pollIntervalMs: options?.pollIntervalMs ?? 3_000,
+    };
+}
+/**
+ * Check if a message matches the filter criteria.
+ */
+export function messageMatches(msg, subjectContains, fromContains) {
+    if (subjectContains) {
+        if (!msg.subject.toLowerCase().includes(subjectContains.toLowerCase())) {
+            return false;
+        }
+    }
+    if (fromContains) {
+        const fromField = `${msg.from} ${msg.fromName ?? ""}`.toLowerCase();
+        if (!fromField.includes(fromContains.toLowerCase())) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Extract verification code from an email body.
+ * Looks for common patterns: 4-8 digit codes, alphanumeric codes, etc.
+ */
+export function extractVerificationCode(msg) {
+    const text = msg.bodyText ?? stripHtml(msg.bodyHtml ?? "");
+    if (!text)
+        return null;
+    // Common patterns for verification codes:
+    // "code is 123456" / "verification code: 123456" / "Your code: ABC123"
+    const patterns = [
+        /(?:code|verification|verify|otp|pin|passcode)\s*(?:is|:|-|=)?\s*([A-Z0-9]{4,8})\b/i,
+        /\b(\d{4,8})\b/, // Just a 4-8 digit number
+        /\b([A-Z0-9]{6})\b/, // 6-char alphanumeric
+        /\b([A-Z0-9]{5})\b/, // 5-char alphanumeric
+        /\b([A-Z0-9]{4})\b/, // 4-char alphanumeric
+    ];
+    // Try contextual patterns first (more reliable)
+    for (const pattern of patterns) {
+        const match = text.match(pattern);
+        if (match) {
+            return match[1] ?? match[0];
+        }
+    }
+    return null;
+}
+/**
+ * Strip HTML tags and return plain text.
+ */
+export function stripHtml(html) {
+    return html
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,4BAA4B,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,OAAO,KAAK,GAAG,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAkD;IAElD,OAAO;QACL,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,EAAE;QAC/C,YAAY,EAAE,OAAO,EAAE,YAAY,IAAI,EAAE;QACzC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,MAAM;QACvC,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,KAAK;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAsC,EACtC,eAAuB,EACvB,YAAoB;IAEpB,IAAI,eAAe,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;QACpE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAsC;IAEtC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAE3D,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,0CAA0C;IAC1C,uEAAuE;IACvE,MAAM,QAAQ,GAAa;QACzB,oFAAoF;QACpF,eAAe,EAAE,0BAA0B;QAC3C,mBAAmB,EAAE,sBAAsB;QAC3C,mBAAmB,EAAE,sBAAsB;QAC3C,mBAAmB,EAAE,sBAAsB;KAC5C,CAAC;IAEF,gDAAgD;IAChD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;SAC9C,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;SAChD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@bencibro/tempmail-mcp",
+  "version": "0.0.1",
+  "description": "A MCP server that provides temporary email services for registration verification, aggregating multiple temp mail providers.",
+  "license": "MIT",
+  "author": "",
+  "homepage": "https://github.com/Bencibr/tempmailmcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Bencibr/tempmailmcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Bencibr/tempmailmcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "temp-mail",
+    "temporary-email",
+    "disposable-email",
+    "verification",
+    "model-context-protocol",
+    "claude",
+    "ai"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tempmail-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "GUIDE.md",
+    "GUIDE.zh-CN.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "node test-e2e.mjs",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.7.3"
+  }
+}