@mcp-z/mcp-gmail 1.0.0

package/dist/cjs/setup/http.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createHTTPServer", {
+    enumerable: true,
+    get: function() {
+        return createHTTPServer;
+    }
+});
+var _server = require("@mcp-z/server");
+var _mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
+var _cors = /*#__PURE__*/ _interop_require_default(require("cors"));
+var _express = /*#__PURE__*/ _interop_require_default(require("express"));
+var _runtime = require("./runtime.js");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+function createHTTPServer(config, overrides) {
+    return _async_to_generator(function() {
+        var runtime, modules, layers, composed, logger, port, tools, prompts, mcpServer, app, fileRouter, _ref, close, httpServer;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    return [
+                        4,
+                        (0, _runtime.createDefaultRuntime)(config, overrides)
+                    ];
+                case 1:
+                    runtime = _state.sent();
+                    modules = runtime.createDomainModules();
+                    layers = runtime.middlewareFactories.map(function(factory) {
+                        return factory(runtime.deps);
+                    });
+                    composed = (0, _server.composeMiddleware)(modules, layers);
+                    logger = runtime.deps.logger;
+                    port = config.transport.port;
+                    if (!port) throw new Error('Port is required for HTTP transport');
+                    tools = _to_consumable_array(composed.tools).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountTools));
+                    prompts = _to_consumable_array(composed.prompts).concat(_to_consumable_array(runtime.deps.oauthAdapters.accountPrompts));
+                    mcpServer = new _mcp.McpServer({
+                        name: config.name,
+                        version: config.version
+                    });
+                    (0, _server.registerTools)(mcpServer, tools);
+                    (0, _server.registerResources)(mcpServer, composed.resources);
+                    (0, _server.registerPrompts)(mcpServer, prompts);
+                    app = (0, _express.default)();
+                    app.use((0, _cors.default)());
+                    app.use(_express.default.json({
+                        limit: '10mb'
+                    }));
+                    fileRouter = (0, _server.createFileServingRouter)({
+                        storageDir: config.storageDir
+                    }, {
+                        contentType: 'text/csv',
+                        contentDisposition: 'attachment'
+                    });
+                    app.use('/files', fileRouter);
+                    if (runtime.deps.oauthAdapters.dcrRouter) {
+                        app.use('/', runtime.deps.oauthAdapters.dcrRouter);
+                        logger.info('Mounted DCR router with OAuth endpoints');
+                    }
+                    logger.info("Starting ".concat(config.name, " MCP server (http)"));
+                    return [
+                        4,
+                        (0, _server.connectHttp)(mcpServer, {
+                            logger: logger,
+                            app: app,
+                            port: port
+                        })
+                    ];
+                case 2:
+                    _ref = _state.sent(), close = _ref.close, httpServer = _ref.httpServer;
+                    logger.info('http transport ready');
+                    return [
+                        2,
+                        {
+                            httpServer: httpServer,
+                            mcpServer: mcpServer,
+                            logger: logger,
+                            close: function() {
+                                return _async_to_generator(function() {
+                                    return _ts_generator(this, function(_state) {
+                                        switch(_state.label){
+                                            case 0:
+                                                return [
+                                                    4,
+                                                    close()
+                                                ];
+                                            case 1:
+                                                _state.sent();
+                                                return [
+                                                    4,
+                                                    runtime.close()
+                                                ];
+                                            case 2:
+                                                _state.sent();
+                                                return [
+                                                    2
+                                                ];
+                                        }
+                                    });
+                                })();
+                            }
+                        }
+                    ];
+            }
+        });
+    })();
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/setup/http.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/http.ts"],"sourcesContent":["import { composeMiddleware, connectHttp, createFileServingRouter, registerPrompts, registerResources, registerTools } from '@mcp-z/server';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport cors from 'cors';\nimport express from 'express';\nimport type { RuntimeOverrides, ServerConfig } from '../types.js';\nimport { createDefaultRuntime } from './runtime.js';\n\nexport async function createHTTPServer(config: ServerConfig, overrides?: RuntimeOverrides) {\n  const runtime = await createDefaultRuntime(config, overrides);\n  const modules = runtime.createDomainModules();\n  const layers = runtime.middlewareFactories.map((factory) => factory(runtime.deps));\n  const composed = composeMiddleware(modules, layers);\n  const logger = runtime.deps.logger;\n  const port = config.transport.port;\n  if (!port) throw new Error('Port is required for HTTP transport');\n\n  const tools = [...composed.tools, ...runtime.deps.oauthAdapters.accountTools];\n  const prompts = [...composed.prompts, ...runtime.deps.oauthAdapters.accountPrompts];\n\n  const mcpServer = new McpServer({ name: config.name, version: config.version });\n  registerTools(mcpServer, tools);\n  registerResources(mcpServer, composed.resources);\n  registerPrompts(mcpServer, prompts);\n\n  const app = express();\n  app.use(cors());\n  app.use(express.json({ limit: '10mb' }));\n\n  const fileRouter = createFileServingRouter({ storageDir: config.storageDir }, { contentType: 'text/csv', contentDisposition: 'attachment' });\n  app.use('/files', fileRouter);\n\n  if (runtime.deps.oauthAdapters.dcrRouter) {\n    app.use('/', runtime.deps.oauthAdapters.dcrRouter);\n    logger.info('Mounted DCR router with OAuth endpoints');\n  }\n\n  logger.info(`Starting ${config.name} MCP server (http)`);\n  const { close, httpServer } = await connectHttp(mcpServer, { logger, app, port });\n  logger.info('http transport ready');\n\n  return {\n    httpServer,\n    mcpServer,\n    logger,\n    close: async () => {\n      await close();\n      await runtime.close();\n    },\n  };\n}\n"],"names":["createHTTPServer","config","overrides","runtime","modules","layers","composed","logger","port","tools","prompts","mcpServer","app","fileRouter","close","httpServer","createDefaultRuntime","createDomainModules","middlewareFactories","map","factory","deps","composeMiddleware","transport","Error","oauthAdapters","accountTools","accountPrompts","McpServer","name","version","registerTools","registerResources","resources","registerPrompts","express","use","cors","json","limit","createFileServingRouter","storageDir","contentType","contentDisposition","dcrRouter","info","connectHttp"],"mappings":";;;;+BAOsBA;;;eAAAA;;;sBAPqG;mBACjG;2DACT;8DACG;uBAEiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,SAAeA,iBAAiBC,MAAoB,EAAEC,SAA4B;;YACjFC,SACAC,SACAC,QACAC,UACAC,QACAC,MAGAC,OACAC,SAEAC,WAKAC,KAIAC,YASwB,MAAtBC,OAAOC;;;;oBA7BC;;wBAAMC,IAAAA,6BAAoB,EAACf,QAAQC;;;oBAA7CC,UAAU;oBACVC,UAAUD,QAAQc,mBAAmB;oBACrCZ,SAASF,QAAQe,mBAAmB,CAACC,GAAG,CAAC,SAACC;+BAAYA,QAAQjB,QAAQkB,IAAI;;oBAC1Ef,WAAWgB,IAAAA,yBAAiB,EAAClB,SAASC;oBACtCE,SAASJ,QAAQkB,IAAI,CAACd,MAAM;oBAC5BC,OAAOP,OAAOsB,SAAS,CAACf,IAAI;oBAClC,IAAI,CAACA,MAAM,MAAM,IAAIgB,MAAM;oBAErBf,QAAQ,AAAC,qBAAGH,SAASG,KAAK,SAAE,qBAAGN,QAAQkB,IAAI,CAACI,aAAa,CAACC,YAAY;oBACtEhB,UAAU,AAAC,qBAAGJ,SAASI,OAAO,SAAE,qBAAGP,QAAQkB,IAAI,CAACI,aAAa,CAACE,cAAc;oBAE5EhB,YAAY,IAAIiB,cAAS,CAAC;wBAAEC,MAAM5B,OAAO4B,IAAI;wBAAEC,SAAS7B,OAAO6B,OAAO;oBAAC;oBAC7EC,IAAAA,qBAAa,EAACpB,WAAWF;oBACzBuB,IAAAA,yBAAiB,EAACrB,WAAWL,SAAS2B,SAAS;oBAC/CC,IAAAA,uBAAe,EAACvB,WAAWD;oBAErBE,MAAMuB,IAAAA,gBAAO;oBACnBvB,IAAIwB,GAAG,CAACC,IAAAA,aAAI;oBACZzB,IAAIwB,GAAG,CAACD,gBAAO,CAACG,IAAI,CAAC;wBAAEC,OAAO;oBAAO;oBAE/B1B,aAAa2B,IAAAA,+BAAuB,EAAC;wBAAEC,YAAYxC,OAAOwC,UAAU;oBAAC,GAAG;wBAAEC,aAAa;wBAAYC,oBAAoB;oBAAa;oBAC1I/B,IAAIwB,GAAG,CAAC,UAAUvB;oBAElB,IAAIV,QAAQkB,IAAI,CAACI,aAAa,CAACmB,SAAS,EAAE;wBACxChC,IAAIwB,GAAG,CAAC,KAAKjC,QAAQkB,IAAI,CAACI,aAAa,CAACmB,SAAS;wBACjDrC,OAAOsC,IAAI,CAAC;oBACd;oBAEAtC,OAAOsC,IAAI,CAAC,AAAC,YAAuB,OAAZ5C,OAAO4B,IAAI,EAAC;oBACN;;wBAAMiB,IAAAA,mBAAW,EAACnC,WAAW;4BAAEJ,QAAAA;4BAAQK,KAAAA;4BAAKJ,MAAAA;wBAAK;;;oBAAjD,OAAA,eAAtBM,QAAsB,KAAtBA,OAAOC,aAAe,KAAfA;oBACfR,OAAOsC,IAAI,CAAC;oBAEZ;;wBAAO;4BACL9B,YAAAA;4BACAJ,WAAAA;4BACAJ,QAAAA;4BACAO,OAAO;;;;;gDACL;;oDAAMA;;;gDAAN;gDACA;;oDAAMX,QAAQW,KAAK;;;gDAAnB;;;;;;gCACF;;wBACF;;;;IACF"}

package/dist/cjs/setup/index.d.cts

@@ -0,0 +1,5 @@
+export { createConfig, parseConfig } from './config.js';
+export { createHTTPServer } from './http.js';
+export { createOAuthAdapters } from './oauth-google.js';
+export * from './runtime.js';
+export { createStdioServer } from './stdio.js';

package/dist/cjs/setup/index.d.ts

@@ -0,0 +1,5 @@
+export { createConfig, parseConfig } from './config.js';
+export { createHTTPServer } from './http.js';
+export { createOAuthAdapters } from './oauth-google.js';
+export * from './runtime.js';
+export { createStdioServer } from './stdio.js';

package/dist/cjs/setup/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get createConfig () {
+        return _config.createConfig;
+    },
+    get createHTTPServer () {
+        return _http.createHTTPServer;
+    },
+    get createOAuthAdapters () {
+        return _oauthgoogle.createOAuthAdapters;
+    },
+    get createStdioServer () {
+        return _stdio.createStdioServer;
+    },
+    get parseConfig () {
+        return _config.parseConfig;
+    }
+});
+var _config = require("./config.js");
+var _http = require("./http.js");
+var _oauthgoogle = require("./oauth-google.js");
+_export_star(require("./runtime.js"), exports);
+var _stdio = require("./stdio.js");
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/setup/index.ts"],"sourcesContent":["export { createConfig, parseConfig } from './config.js';\nexport { createHTTPServer } from './http.js';\nexport { createOAuthAdapters } from './oauth-google.js';\nexport * from './runtime.js';\nexport { createStdioServer } from './stdio.js';\n"],"names":["createConfig","createHTTPServer","createOAuthAdapters","createStdioServer","parseConfig"],"mappings":";;;;;;;;;;;QAASA;eAAAA,oBAAY;;QACZC;eAAAA,sBAAgB;;QAChBC;eAAAA,gCAAmB;;QAEnBC;eAAAA,wBAAiB;;QAJHC;eAAAA,mBAAW;;;sBAAQ;oBACT;2BACG;qBACtB;qBACoB"}

package/dist/cjs/setup/oauth-google.d.cts

@@ -0,0 +1,54 @@
+import { type AuthEmailProvider } from '@mcp-z/oauth';
+import type { CachedToken } from '@mcp-z/oauth-google';
+import { DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';
+import type { Logger, PromptModule, ToolModule } from '@mcp-z/server';
+import type { Router } from 'express';
+import type { Keyv } from 'keyv';
+import type { ServerConfig } from '../types.js';
+/**
+ * Gmail OAuth runtime dependencies.
+ */
+export interface OAuthRuntimeDeps {
+    logger: Logger;
+    tokenStore: Keyv<CachedToken>;
+    dcrStore?: Keyv<unknown>;
+}
+/**
+ * Auth middleware helpers used to wrap MCP modules.
+ */
+export interface AuthMiddleware {
+    withToolAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withResourceAuth<T extends {
+        name: string;
+        template?: unknown;
+        config?: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withPromptAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+}
+/**
+ * Result returned by createOAuthAdapters.
+ */
+export interface OAuthAdapters {
+    primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;
+    middleware: AuthMiddleware;
+    authAdapter: AuthEmailProvider;
+    accountTools: ToolModule[];
+    accountPrompts: PromptModule[];
+    dcrRouter?: Router;
+}
+/**
+ * Create Gmail OAuth adapters and helpers.
+ *
+ * @param config Gmail server configuration.
+ * @param deps Runtime dependencies (logger, token store, optional DCR store).
+ */
+export declare function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters>;

package/dist/cjs/setup/oauth-google.d.ts

@@ -0,0 +1,54 @@
+import { type AuthEmailProvider } from '@mcp-z/oauth';
+import type { CachedToken } from '@mcp-z/oauth-google';
+import { DcrOAuthProvider, LoopbackOAuthProvider, ServiceAccountProvider } from '@mcp-z/oauth-google';
+import type { Logger, PromptModule, ToolModule } from '@mcp-z/server';
+import type { Router } from 'express';
+import type { Keyv } from 'keyv';
+import type { ServerConfig } from '../types.js';
+/**
+ * Gmail OAuth runtime dependencies.
+ */
+export interface OAuthRuntimeDeps {
+    logger: Logger;
+    tokenStore: Keyv<CachedToken>;
+    dcrStore?: Keyv<unknown>;
+}
+/**
+ * Auth middleware helpers used to wrap MCP modules.
+ */
+export interface AuthMiddleware {
+    withToolAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withResourceAuth<T extends {
+        name: string;
+        template?: unknown;
+        config?: unknown;
+        handler: unknown;
+    }>(module: T): T;
+    withPromptAuth<T extends {
+        name: string;
+        config: unknown;
+        handler: unknown;
+    }>(module: T): T;
+}
+/**
+ * Result returned by createOAuthAdapters.
+ */
+export interface OAuthAdapters {
+    primary: LoopbackOAuthProvider | ServiceAccountProvider | DcrOAuthProvider;
+    middleware: AuthMiddleware;
+    authAdapter: AuthEmailProvider;
+    accountTools: ToolModule[];
+    accountPrompts: PromptModule[];
+    dcrRouter?: Router;
+}
+/**
+ * Create Gmail OAuth adapters and helpers.
+ *
+ * @param config Gmail server configuration.
+ * @param deps Runtime dependencies (logger, token store, optional DCR store).
+ */
+export declare function createOAuthAdapters(config: ServerConfig, deps: OAuthRuntimeDeps, baseUrl?: string): Promise<OAuthAdapters>;