@jaypie/mcp 0.1.5 → 0.1.7

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Finlayson Studio, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/createMcpServer.d.ts

@@ -1,7 +1,11 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface CreateMcpServerOptions {
+    version?: string;
+    verbose?: boolean;
+}
 /**
  * Creates and configures an MCP server instance with Jaypie tools
- * @param version - The version string for the server
+ * @param options - Configuration options (or legacy version string)
  * @returns Configured MCP server instance
  */
-export declare function createMcpServer(version?: string): McpServer;
+export declare function createMcpServer(options?: CreateMcpServerOptions | string): McpServer;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
 export { createMcpServer } from "./createMcpServer.js";
+export type { CreateMcpServerOptions } from "./createMcpServer.js";
 export { mcpExpressHandler, type McpExpressHandlerOptions, } from "./mcpExpressHandler.js";

package/dist/index.js

@@ -13,6 +13,19 @@ import { randomUUID } from 'node:crypto';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const PROMPTS_PATH = path.join(__dirname, "..", "prompts");
+// Logger utility
+function createLogger(verbose) {
+    return {
+        info: (message, ...args) => {
+            if (verbose) {
+                console.error(`[jaypie-mcp] ${message}`, ...args);
+            }
+        },
+        error: (message, ...args) => {
+            console.error(`[jaypie-mcp ERROR] ${message}`, ...args);
+        },
+    };
+}
 async function parseMarkdownFile(filePath) {
     try {
         const content = await fs.readFile(filePath, "utf-8");
@@ -49,22 +62,33 @@ function formatPromptListItem(prompt) {
 }
 /**
  * Creates and configures an MCP server instance with Jaypie tools
- * @param version - The version string for the server
+ * @param options - Configuration options (or legacy version string)
  * @returns Configured MCP server instance
  */
-function createMcpServer(version = "0.0.0") {
+function createMcpServer(options = {}) {
+    // Support legacy signature: createMcpServer(version: string)
+    const config = typeof options === "string" ? { version: options } : options;
+    const { version = "0.0.0", verbose = false } = config;
+    const log = createLogger(verbose);
+    log.info("Creating MCP server instance");
+    log.info(`Prompts directory: ${PROMPTS_PATH}`);
     const server = new McpServer({
         name: "jaypie",
         version,
     }, {
         capabilities: {},
     });
+    log.info("Registering tools...");
     server.tool("list_prompts", "Returns a bulleted list of all .md files in the prompts directory with their descriptions and requirements", {}, async () => {
+        log.info("Tool called: list_prompts");
+        log.info(`Reading directory: ${PROMPTS_PATH}`);
         try {
             const files = await fs.readdir(PROMPTS_PATH);
             const mdFiles = files.filter((file) => file.endsWith(".md"));
+            log.info(`Found ${mdFiles.length} .md files`);
             const prompts = await Promise.all(mdFiles.map((file) => parseMarkdownFile(path.join(PROMPTS_PATH, file))));
             const formattedList = prompts.map(formatPromptListItem).join("\n");
+            log.info("Successfully listed prompts");
             return {
                 content: [
                     {
@@ -75,6 +99,7 @@ function createMcpServer(version = "0.0.0") {
             };
         }
         catch (error) {
+            log.error("Error listing prompts:", error);
             return {
                 content: [
                     {
@@ -85,14 +110,18 @@ function createMcpServer(version = "0.0.0") {
             };
         }
     });
+    log.info("Registered tool: list_prompts");
     server.tool("read_prompt", "Returns the contents of a specified prompt file", {
         filename: z
             .string()
             .describe("The name of the prompt file to read (e.g., example_prompt.md)"),
     }, async ({ filename }) => {
+        log.info(`Tool called: read_prompt (filename: ${filename})`);
         try {
             const filePath = path.join(PROMPTS_PATH, filename);
+            log.info(`Reading file: ${filePath}`);
             const content = await fs.readFile(filePath, "utf-8");
+            log.info(`Successfully read ${filename} (${content.length} bytes)`);
             return {
                 content: [
                     {
@@ -104,6 +133,7 @@ function createMcpServer(version = "0.0.0") {
         }
         catch (error) {
             if (error.code === "ENOENT") {
+                log.error(`File not found: ${filename}`);
                 return {
                     content: [
                         {
@@ -113,6 +143,7 @@ function createMcpServer(version = "0.0.0") {
                     ],
                 };
             }
+            log.error("Error reading prompt file:", error);
             return {
                 content: [
                     {
@@ -123,6 +154,8 @@ function createMcpServer(version = "0.0.0") {
             };
         }
     });
+    log.info("Registered tool: read_prompt");
+    log.info("MCP server configuration complete");
     return server;
 }
 
@@ -132,7 +165,7 @@ const DEFAULT_VERSION = "0.0.0";
  * Creates an Express handler for the Jaypie MCP server using HTTP transport
  *
  * @param options - Configuration options for the handler
- * @returns Express middleware function
+ * @returns Promise that resolves to an Express middleware function
  *
  * @example
  * ```typescript
@@ -142,7 +175,8 @@ const DEFAULT_VERSION = "0.0.0";
  * const app = express();
  * app.use(express.json());
  *
- * app.use('/mcp', mcpExpressHandler({
+ * // Note: mcpExpressHandler is now async
+ * app.use('/mcp', await mcpExpressHandler({
  *   version: '1.0.0',
  *   enableSessions: true
  * }));
@@ -152,14 +186,14 @@ const DEFAULT_VERSION = "0.0.0";
  * });
  * ```
  */
-function mcpExpressHandler(options = {}) {
+async function mcpExpressHandler(options = {}) {
     const { version = DEFAULT_VERSION, enableSessions = true, sessionIdGenerator = () => randomUUID(), enableJsonResponse = false, } = options;
     const server = createMcpServer(version);
     const transport = new StreamableHTTPServerTransport({
         sessionIdGenerator: enableSessions ? sessionIdGenerator : undefined,
         enableJsonResponse,
     });
-    server.connect(transport);
+    await server.connect(transport);
     return async (req, res) => {
         try {
             await transport.handleRequest(req, res, req.body);
@@ -177,10 +211,74 @@ function mcpExpressHandler(options = {}) {
 
 // Version will be injected during build
 const version = "0.0.0";
+// Parse command-line arguments
+const args = process.argv.slice(2);
+const verbose = args.includes("--verbose") || args.includes("-v");
+// Logger for verbose mode (uses stderr to not interfere with JSON-RPC on stdout)
+const log = {
+    info: (message, ...args) => {
+        if (verbose) {
+            console.error(`[jaypie-mcp] ${message}`, ...args);
+        }
+    },
+    error: (message, ...args) => {
+        console.error(`[jaypie-mcp ERROR] ${message}`, ...args);
+    },
+};
+let server = null;
+let isShuttingDown = false;
+async function gracefulShutdown(exitCode = 0) {
+    if (isShuttingDown) {
+        return;
+    }
+    isShuttingDown = true;
+    log.info("Shutting down gracefully...");
+    try {
+        if (server) {
+            await server.close();
+            log.info("Server closed successfully");
+        }
+    }
+    catch (error) {
+        log.error("Error during shutdown:", error);
+    }
+    finally {
+        process.exit(exitCode);
+    }
+}
 async function main() {
-    const server = createMcpServer(version);
+    log.info("Starting Jaypie MCP server...");
+    log.info(`Version: ${version}`);
+    log.info(`Node version: ${process.version}`);
+    log.info(`Verbose mode: ${verbose ? "enabled" : "disabled"}`);
+    server = createMcpServer({ version, verbose });
+    log.info("MCP server created successfully");
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    log.info("Connected to stdio transport");
+    log.info("Server is ready to accept requests");
+    // Handle process termination signals
+    process.on("SIGINT", () => {
+        log.info("Received SIGINT signal");
+        gracefulShutdown(0);
+    });
+    process.on("SIGTERM", () => {
+        log.info("Received SIGTERM signal");
+        gracefulShutdown(0);
+    });
+    // Handle stdio stream errors (but let transport handle normal stdin end/close)
+    process.stdin.on("error", (error) => {
+        if (error.message?.includes("EPIPE") || error.message?.includes("EOF")) {
+            log.info("stdin closed");
+            gracefulShutdown(0);
+        }
+    });
+    process.stdout.on("error", (error) => {
+        if (error.message?.includes("EPIPE")) {
+            log.info("stdout pipe broken");
+            gracefulShutdown(0);
+        }
+    });
     // Server is running on stdio
 }
 // Only run main() if this module is executed directly (not imported)
@@ -189,7 +287,10 @@ if (process.argv[1]) {
     const realPath = realpathSync(process.argv[1]);
     const realPathAsUrl = pathToFileURL(realPath).href;
     if (import.meta.url === realPathAsUrl) {
-        main();
+        main().catch((error) => {
+            log.error("Fatal error:", error);
+            process.exit(1);
+        });
     }
 }
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/createMcpServer.ts","../src/mcpExpressHandler.ts","../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport matter from \"gray-matter\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\nconst PROMPTS_PATH = path.join(__dirname, \"..\", \"prompts\");\n\ninterface FrontMatter {\n  description?: string;\n  include?: string;\n  globs?: string;\n}\n\nasync function parseMarkdownFile(filePath: string): Promise<{\n  filename: string;\n  description?: string;\n  include?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const filename = path.basename(filePath);\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as FrontMatter;\n      return {\n        filename,\n        description: frontMatter.description,\n        include: frontMatter.include || frontMatter.globs,\n      };\n    }\n\n    return { filename };\n  } catch {\n    return { filename: path.basename(filePath) };\n  }\n}\n\nfunction formatPromptListItem(prompt: {\n  filename: string;\n  description?: string;\n  include?: string;\n}): string {\n  const { filename, description, include } = prompt;\n\n  if (description && include) {\n    return `* ${filename}: ${description} - Required for ${include}`;\n  } else if (description) {\n    return `* ${filename}: ${description}`;\n  } else if (include) {\n    return `* ${filename} - Required for ${include}`;\n  } else {\n    return `* ${filename}`;\n  }\n}\n\n/**\n * Creates and configures an MCP server instance with Jaypie tools\n * @param version - The version string for the server\n * @returns Configured MCP server instance\n */\nexport function createMcpServer(version: string = \"0.0.0\"): McpServer {\n  const server = new McpServer(\n    {\n      name: \"jaypie\",\n      version,\n    },\n    {\n      capabilities: {},\n    },\n  );\n\n  server.tool(\n    \"list_prompts\",\n    \"Returns a bulleted list of all .md files in the prompts directory with their descriptions and requirements\",\n    {},\n    async () => {\n      try {\n        const files = await fs.readdir(PROMPTS_PATH);\n        const mdFiles = files.filter((file) => file.endsWith(\".md\"));\n\n        const prompts = await Promise.all(\n          mdFiles.map((file) =>\n            parseMarkdownFile(path.join(PROMPTS_PATH, file)),\n          ),\n        );\n\n        const formattedList = prompts.map(formatPromptListItem).join(\"\\n\");\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text:\n                formattedList || \"No .md files found in the prompts directory.\",\n            },\n          ],\n        };\n      } catch (error) {\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Error listing prompts: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n            },\n          ],\n        };\n      }\n    },\n  );\n\n  server.tool(\n    \"read_prompt\",\n    \"Returns the contents of a specified prompt file\",\n    {\n      filename: z\n        .string()\n        .describe(\n          \"The name of the prompt file to read (e.g., example_prompt.md)\",\n        ),\n    },\n    async ({ filename }) => {\n      try {\n        const filePath = path.join(PROMPTS_PATH, filename);\n        const content = await fs.readFile(filePath, \"utf-8\");\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: content,\n            },\n          ],\n        };\n      } catch (error) {\n        if ((error as { code?: string }).code === \"ENOENT\") {\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: `Error: Prompt file \"${filename}\" not found in prompts directory`,\n              },\n            ],\n          };\n        }\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Error reading prompt file: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n            },\n          ],\n        };\n      }\n    },\n  );\n\n  return server;\n}\n","import { Request, Response } from \"express\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { randomUUID } from \"node:crypto\";\nimport { createMcpServer } from \"./createMcpServer.js\";\n\n// Version will be injected during build\nconst DEFAULT_VERSION = \"0.0.0\";\n\n/**\n * Options for configuring the MCP Express handler\n */\nexport interface McpExpressHandlerOptions {\n  /**\n   * Version string for the MCP server\n   */\n  version?: string;\n  /**\n   * Whether to enable session management (stateful mode)\n   * Default: true\n   */\n  enableSessions?: boolean;\n  /**\n   * Custom session ID generator function\n   */\n  sessionIdGenerator?: () => string;\n  /**\n   * Enable JSON responses instead of SSE streaming\n   * Default: false\n   */\n  enableJsonResponse?: boolean;\n}\n\n/**\n * Creates an Express handler for the Jaypie MCP server using HTTP transport\n *\n * @param options - Configuration options for the handler\n * @returns Express middleware function\n *\n * @example\n * ```typescript\n * import express from 'express';\n * import { mcpExpressHandler } from '@jaypie/mcp';\n *\n * const app = express();\n * app.use(express.json());\n *\n * app.use('/mcp', mcpExpressHandler({\n *   version: '1.0.0',\n *   enableSessions: true\n * }));\n *\n * app.listen(3000, () => {\n *   console.log('MCP server running on http://localhost:3000/mcp');\n * });\n * ```\n */\nexport function mcpExpressHandler(\n  options: McpExpressHandlerOptions = {},\n): (req: Request, res: Response) => Promise<void> {\n  const {\n    version = DEFAULT_VERSION,\n    enableSessions = true,\n    sessionIdGenerator = () => randomUUID(),\n    enableJsonResponse = false,\n  } = options;\n\n  const server = createMcpServer(version);\n\n  const transport = new StreamableHTTPServerTransport({\n    sessionIdGenerator: enableSessions ? sessionIdGenerator : undefined,\n    enableJsonResponse,\n  });\n\n  server.connect(transport);\n\n  return async (req: Request, res: Response): Promise<void> => {\n    try {\n      await transport.handleRequest(req, res, req.body);\n    } catch (error) {\n      if (!res.headersSent) {\n        res.status(500).json({\n          error: \"Internal server error\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        });\n      }\n    }\n  };\n}\n","#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createMcpServer } from \"./createMcpServer.js\";\n\n// Version will be injected during build\nconst version = \"0.0.0\";\n\nasync function main() {\n  const server = createMcpServer(version);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  // Server is running on stdio\n}\n\n// Only run main() if this module is executed directly (not imported)\n// This handles npx and symlinks in node_modules/.bin correctly\nif (process.argv[1]) {\n  const realPath = realpathSync(process.argv[1]);\n  const realPathAsUrl = pathToFileURL(realPath).href;\n  if (import.meta.url === realPathAsUrl) {\n    main();\n  }\n}\n\nexport { createMcpServer } from \"./createMcpServer.js\";\nexport {\n  mcpExpressHandler,\n  type McpExpressHandlerOptions,\n} from \"./mcpExpressHandler.js\";\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/createMcpServer.ts","../src/mcpExpressHandler.ts","../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport matter from \"gray-matter\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\nconst PROMPTS_PATH = path.join(__dirname, \"..\", \"prompts\");\n\nexport interface CreateMcpServerOptions {\n  version?: string;\n  verbose?: boolean;\n}\n\n// Logger utility\nfunction createLogger(verbose: boolean) {\n  return {\n    info: (message: string, ...args: unknown[]) => {\n      if (verbose) {\n        console.error(`[jaypie-mcp] ${message}`, ...args);\n      }\n    },\n    error: (message: string, ...args: unknown[]) => {\n      console.error(`[jaypie-mcp ERROR] ${message}`, ...args);\n    },\n  };\n}\n\ninterface FrontMatter {\n  description?: string;\n  include?: string;\n  globs?: string;\n}\n\nasync function parseMarkdownFile(filePath: string): Promise<{\n  filename: string;\n  description?: string;\n  include?: string;\n}> {\n  try {\n    const content = await fs.readFile(filePath, \"utf-8\");\n    const filename = path.basename(filePath);\n\n    if (content.startsWith(\"---\")) {\n      const parsed = matter(content);\n      const frontMatter = parsed.data as FrontMatter;\n      return {\n        filename,\n        description: frontMatter.description,\n        include: frontMatter.include || frontMatter.globs,\n      };\n    }\n\n    return { filename };\n  } catch {\n    return { filename: path.basename(filePath) };\n  }\n}\n\nfunction formatPromptListItem(prompt: {\n  filename: string;\n  description?: string;\n  include?: string;\n}): string {\n  const { filename, description, include } = prompt;\n\n  if (description && include) {\n    return `* ${filename}: ${description} - Required for ${include}`;\n  } else if (description) {\n    return `* ${filename}: ${description}`;\n  } else if (include) {\n    return `* ${filename} - Required for ${include}`;\n  } else {\n    return `* ${filename}`;\n  }\n}\n\n/**\n * Creates and configures an MCP server instance with Jaypie tools\n * @param options - Configuration options (or legacy version string)\n * @returns Configured MCP server instance\n */\nexport function createMcpServer(\n  options: CreateMcpServerOptions | string = {},\n): McpServer {\n  // Support legacy signature: createMcpServer(version: string)\n  const config: CreateMcpServerOptions =\n    typeof options === \"string\" ? { version: options } : options;\n\n  const { version = \"0.0.0\", verbose = false } = config;\n\n  const log = createLogger(verbose);\n\n  log.info(\"Creating MCP server instance\");\n  log.info(`Prompts directory: ${PROMPTS_PATH}`);\n\n  const server = new McpServer(\n    {\n      name: \"jaypie\",\n      version,\n    },\n    {\n      capabilities: {},\n    },\n  );\n\n  log.info(\"Registering tools...\");\n\n  server.tool(\n    \"list_prompts\",\n    \"Returns a bulleted list of all .md files in the prompts directory with their descriptions and requirements\",\n    {},\n    async () => {\n      log.info(\"Tool called: list_prompts\");\n      log.info(`Reading directory: ${PROMPTS_PATH}`);\n\n      try {\n        const files = await fs.readdir(PROMPTS_PATH);\n        const mdFiles = files.filter((file) => file.endsWith(\".md\"));\n\n        log.info(`Found ${mdFiles.length} .md files`);\n\n        const prompts = await Promise.all(\n          mdFiles.map((file) =>\n            parseMarkdownFile(path.join(PROMPTS_PATH, file)),\n          ),\n        );\n\n        const formattedList = prompts.map(formatPromptListItem).join(\"\\n\");\n\n        log.info(\"Successfully listed prompts\");\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text:\n                formattedList || \"No .md files found in the prompts directory.\",\n            },\n          ],\n        };\n      } catch (error) {\n        log.error(\"Error listing prompts:\", error);\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Error listing prompts: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n            },\n          ],\n        };\n      }\n    },\n  );\n\n  log.info(\"Registered tool: list_prompts\");\n\n  server.tool(\n    \"read_prompt\",\n    \"Returns the contents of a specified prompt file\",\n    {\n      filename: z\n        .string()\n        .describe(\n          \"The name of the prompt file to read (e.g., example_prompt.md)\",\n        ),\n    },\n    async ({ filename }) => {\n      log.info(`Tool called: read_prompt (filename: ${filename})`);\n\n      try {\n        const filePath = path.join(PROMPTS_PATH, filename);\n\n        log.info(`Reading file: ${filePath}`);\n\n        const content = await fs.readFile(filePath, \"utf-8\");\n\n        log.info(`Successfully read ${filename} (${content.length} bytes)`);\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: content,\n            },\n          ],\n        };\n      } catch (error) {\n        if ((error as { code?: string }).code === \"ENOENT\") {\n          log.error(`File not found: ${filename}`);\n\n          return {\n            content: [\n              {\n                type: \"text\" as const,\n                text: `Error: Prompt file \"${filename}\" not found in prompts directory`,\n              },\n            ],\n          };\n        }\n\n        log.error(\"Error reading prompt file:\", error);\n\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Error reading prompt file: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n            },\n          ],\n        };\n      }\n    },\n  );\n\n  log.info(\"Registered tool: read_prompt\");\n  log.info(\"MCP server configuration complete\");\n\n  return server;\n}\n","import { Request, Response } from \"express\";\nimport { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport { randomUUID } from \"node:crypto\";\nimport { createMcpServer } from \"./createMcpServer.js\";\n\n// Version will be injected during build\nconst DEFAULT_VERSION = \"0.0.0\";\n\n/**\n * Options for configuring the MCP Express handler\n */\nexport interface McpExpressHandlerOptions {\n  /**\n   * Version string for the MCP server\n   */\n  version?: string;\n  /**\n   * Whether to enable session management (stateful mode)\n   * Default: true\n   */\n  enableSessions?: boolean;\n  /**\n   * Custom session ID generator function\n   */\n  sessionIdGenerator?: () => string;\n  /**\n   * Enable JSON responses instead of SSE streaming\n   * Default: false\n   */\n  enableJsonResponse?: boolean;\n}\n\n/**\n * Creates an Express handler for the Jaypie MCP server using HTTP transport\n *\n * @param options - Configuration options for the handler\n * @returns Promise that resolves to an Express middleware function\n *\n * @example\n * ```typescript\n * import express from 'express';\n * import { mcpExpressHandler } from '@jaypie/mcp';\n *\n * const app = express();\n * app.use(express.json());\n *\n * // Note: mcpExpressHandler is now async\n * app.use('/mcp', await mcpExpressHandler({\n *   version: '1.0.0',\n *   enableSessions: true\n * }));\n *\n * app.listen(3000, () => {\n *   console.log('MCP server running on http://localhost:3000/mcp');\n * });\n * ```\n */\nexport async function mcpExpressHandler(\n  options: McpExpressHandlerOptions = {},\n): Promise<(req: Request, res: Response) => Promise<void>> {\n  const {\n    version = DEFAULT_VERSION,\n    enableSessions = true,\n    sessionIdGenerator = () => randomUUID(),\n    enableJsonResponse = false,\n  } = options;\n\n  const server = createMcpServer(version);\n\n  const transport = new StreamableHTTPServerTransport({\n    sessionIdGenerator: enableSessions ? sessionIdGenerator : undefined,\n    enableJsonResponse,\n  });\n\n  await server.connect(transport);\n\n  return async (req: Request, res: Response): Promise<void> => {\n    try {\n      await transport.handleRequest(req, res, req.body);\n    } catch (error) {\n      if (!res.headersSent) {\n        res.status(500).json({\n          error: \"Internal server error\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        });\n      }\n    }\n  };\n}\n","#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { pathToFileURL } from \"node:url\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { createMcpServer } from \"./createMcpServer.js\";\n\n// Version will be injected during build\nconst version = \"0.0.0\";\n\n// Parse command-line arguments\nconst args = process.argv.slice(2);\nconst verbose = args.includes(\"--verbose\") || args.includes(\"-v\");\n\n// Logger for verbose mode (uses stderr to not interfere with JSON-RPC on stdout)\nconst log = {\n  info: (message: string, ...args: unknown[]) => {\n    if (verbose) {\n      console.error(`[jaypie-mcp] ${message}`, ...args);\n    }\n  },\n  error: (message: string, ...args: unknown[]) => {\n    console.error(`[jaypie-mcp ERROR] ${message}`, ...args);\n  },\n};\n\nlet server: McpServer | null = null;\nlet isShuttingDown = false;\n\nasync function gracefulShutdown(exitCode = 0) {\n  if (isShuttingDown) {\n    return;\n  }\n  isShuttingDown = true;\n\n  log.info(\"Shutting down gracefully...\");\n\n  try {\n    if (server) {\n      await server.close();\n      log.info(\"Server closed successfully\");\n    }\n  } catch (error) {\n    log.error(\"Error during shutdown:\", error);\n  } finally {\n    process.exit(exitCode);\n  }\n}\n\nasync function main() {\n  log.info(\"Starting Jaypie MCP server...\");\n  log.info(`Version: ${version}`);\n  log.info(`Node version: ${process.version}`);\n  log.info(`Verbose mode: ${verbose ? \"enabled\" : \"disabled\"}`);\n\n  server = createMcpServer({ version, verbose });\n\n  log.info(\"MCP server created successfully\");\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  log.info(\"Connected to stdio transport\");\n  log.info(\"Server is ready to accept requests\");\n\n  // Handle process termination signals\n  process.on(\"SIGINT\", () => {\n    log.info(\"Received SIGINT signal\");\n    gracefulShutdown(0);\n  });\n  process.on(\"SIGTERM\", () => {\n    log.info(\"Received SIGTERM signal\");\n    gracefulShutdown(0);\n  });\n\n  // Handle stdio stream errors (but let transport handle normal stdin end/close)\n  process.stdin.on(\"error\", (error) => {\n    if (error.message?.includes(\"EPIPE\") || error.message?.includes(\"EOF\")) {\n      log.info(\"stdin closed\");\n      gracefulShutdown(0);\n    }\n  });\n\n  process.stdout.on(\"error\", (error) => {\n    if (error.message?.includes(\"EPIPE\")) {\n      log.info(\"stdout pipe broken\");\n      gracefulShutdown(0);\n    }\n  });\n\n  // Server is running on stdio\n}\n\n// Only run main() if this module is executed directly (not imported)\n// This handles npx and symlinks in node_modules/.bin correctly\nif (process.argv[1]) {\n  const realPath = realpathSync(process.argv[1]);\n  const realPathAsUrl = pathToFileURL(realPath).href;\n  if (import.meta.url === realPathAsUrl) {\n    main().catch((error) => {\n      log.error(\"Fatal error:\", error);\n      process.exit(1);\n    });\n  }\n}\n\nexport { createMcpServer } from \"./createMcpServer.js\";\nexport type { CreateMcpServerOptions } from \"./createMcpServer.js\";\nexport {\n  mcpExpressHandler,\n  type McpExpressHandlerOptions,\n} from \"./mcpExpressHandler.js\";\n"],"names":[],"mappings":"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"}

package/dist/mcpExpressHandler.d.ts

@@ -26,7 +26,7 @@ export interface McpExpressHandlerOptions {
  * Creates an Express handler for the Jaypie MCP server using HTTP transport
  *
  * @param options - Configuration options for the handler
- * @returns Express middleware function
+ * @returns Promise that resolves to an Express middleware function
  *
  * @example
  * ```typescript
@@ -36,7 +36,8 @@ export interface McpExpressHandlerOptions {
  * const app = express();
  * app.use(express.json());
  *
- * app.use('/mcp', mcpExpressHandler({
+ * // Note: mcpExpressHandler is now async
+ * app.use('/mcp', await mcpExpressHandler({
  *   version: '1.0.0',
  *   enableSessions: true
  * }));
@@ -46,4 +47,4 @@ export interface McpExpressHandlerOptions {
  * });
  * ```
  */
-export declare function mcpExpressHandler(options?: McpExpressHandlerOptions): (req: Request, res: Response) => Promise<void>;
+export declare function mcpExpressHandler(options?: McpExpressHandlerOptions): Promise<(req: Request, res: Response) => Promise<void>>;

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.1.5",
-  "description": "Jaypie MCP server",
+  "version": "0.1.7",
+  "description": "Jaypie MCP",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/finlaysonstudio/jaypie"
+  },
   "license": "MIT",
   "author": "Finlayson Studio",
   "type": "module",
@@ -41,5 +45,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "14683b303359f95dc63e58998959fddae3c90e97"
 }

package/prompts/Jaypie_Fabricator.md

@@ -0,0 +1,164 @@
+---
+description: coding style resource, helpful when stuck on lint errors
+globs: packages/fabricator/**
+---
+# Brief Guide to @jaypie/fabricator
+
+## Overview
+
+`@jaypie/fabricator` is a test data generation library built on top of `@faker-js/faker` that provides deterministic, seeded data generation with additional utilities for randomness and complex data patterns.
+
+## Core Concepts
+
+### 1. The Fabricator Class
+
+The `Fabricator` class wraps faker.js and provides:
+- **Deterministic seeding**: Pass a string, number, or UUID to get reproducible test data
+- **Direct faker access**: All faker modules are proxied for convenience
+- **Enhanced random number generation**: Built-in `random()` function with advanced options
+- **Custom generators**: Specialized methods like `words()` and `generate.person()`
+
+```typescript
+import { fabricator } from "@jaypie/fabricator";
+
+// Create unseeded (random) fabricator
+const fab = fabricator();
+
+// Create seeded (deterministic) fabricator
+const seededFab = fabricator("my-seed");
+const uuidFab = fabricator("550e8400-e29b-41d4-a716-446655440000");
+```
+
+### 2. Deterministic Seeding
+
+Any string or number can be used as a seed. The same seed always produces the same output:
+
+```typescript
+const fab1 = fabricator("test-seed");
+const fab2 = fabricator("test-seed");
+
+fab1.faker.person.firstName(); // "Jordan"
+fab2.faker.person.firstName(); // "Jordan" (same!)
+```
+
+**UUID Seeding**: UUIDs are converted to numeric arrays using `uuidToBytes` for efficient seeding.
+
+### 3. Random Number Generation
+
+The `random()` function provides advanced randomness with multiple distribution types:
+
+**Basic Usage:**
+```typescript
+fab.random();                          // 0-1 float
+fab.random({ min: 1, max: 10 });      // 1-10 float
+fab.random({ min: 1, max: 10, integer: true }); // 1-10 integer
+```
+
+**Advanced Options:**
+- `min/max`: Bounds (defaults: 0-1)
+- `integer`: Return integers (default: false)
+- `mean/stddev`: Normal distribution
+- `precision`: Decimal places
+- `currency`: Shorthand for precision: 2
+- `start`: Add offset to result
+- `seed`: Override the fabricator's seed for this call only
+
+**Smart Defaults:**
+- If only `min` is set, `max` defaults to `min * 2`
+- Normal distribution with `mean/stddev` can optionally be clamped by `min/max`
+
+### 4. Faker Integration
+
+All faker modules are directly accessible through getters:
+
+```typescript
+fab.person.firstName();
+fab.internet.email();
+fab.location.city();
+fab.company.name();
+// ... all faker modules available
+```
+
+### 5. Custom Methods
+
+#### `words()`: Two-Word Combinations
+Generates one of three patterns randomly:
+- adjective + noun
+- adjective + verb
+- noun + verb
+
+```typescript
+fab.words(); // "happy dog" or "quick run" or "mountain climb"
+```
+
+#### `generate.person(id?)`: Complex Person Generator
+Creates realistic person data with probabilistic variations:
+
+```typescript
+const person = fab.generate.person();
+// {
+//   id: "uuid",
+//   firstName: "Jordan",
+//   middleName: "Alex" | undefined,
+//   lastName: "Smith" | "Smith-Jones",
+//   fullName: "Jordan Smith" | "Jordan Alex Smith"
+// }
+```
+
+**Probabilistic Rules** (using `CHANCE` constants):
+- **firstName**: 2.1% chance (RARE) to be a lastName instead
+- **middleName**:
+  - 14.6% chance (UNCOMMON) to be missing
+  - 2.1% chance (RARE) to be a lastName
+  - 0.307% chance (EPIC) to have two middle names
+- **lastName**: 2.1% chance (RARE) to be hyphenated
+- **fullName**: 14.6% chance (UNCOMMON) to include middle name
+
+**Independent Seeding**: Pass an optional UUID to get deterministic person data that's independent of the parent fabricator's seed:
+
+```typescript
+const person1 = fab1.generate.person("same-uuid");
+const person2 = fab2.generate.person("same-uuid");
+// person1 === person2, regardless of fab1/fab2 seeds
+```
+
+### 6. Probability Constants
+
+```typescript
+export const CHANCE = {
+  UNCOMMON: 0.146,    // ~14.6%
+  RARE: 0.021,        // ~2.1%
+  EPIC: 0.00307,      // ~0.3%
+  LEGENDARY: 0.000441 // ~0.04%
+};
+```
+
+Use these for consistent probability calculations across your test data.
+
+## Architecture
+
+### Internal Utilities
+
+- **`numericSeed()`**: Converts strings to numeric seeds using cyrb53 hash
+- **`uuidToBytes()`**: Converts UUIDs to byte arrays for seeding
+- **`uuidToNumber()`**: Converts UUIDs to single numbers (fallback)
+- **`numericSeedArray()`**: Smart converter that detects UUIDs and uses appropriate conversion
+
+## Key Design Patterns
+
+1. **Subfaker Pattern**: Complex generators create independent seeded faker instances to ensure deterministic output regardless of parent state
+2. **Probabilistic Variations**: Use float rolls with CHANCE constants for realistic data variety
+3. **Proxy Access**: All faker modules exposed through getters for ergonomic API
+4. **Seed Flexibility**: Accepts strings, numbers, or UUIDs as seeds
+
+## Usage in @entpayco/fabricator
+
+Your wrapper package should:
+- Extend or compose `Fabricator` from `@jaypie/fabricator`
+- Add domain-specific generators (payments, accounts, transactions, etc.)
+- Follow the same patterns: seeding, probabilistic variations, subfaker for complex objects
+- Maintain the same function signature standards (single param, config object, or optional config)
+
+---
+
+Ready to build domain-specific test data generators on this foundation!

package/prompts/Jaypie_Init_Monorepo_Project.md

@@ -35,7 +35,7 @@ npm install --save-dev @jaypie/eslint @jaypie/testkit eslint rimraf sort-package
 ## Context
 
 prompts/Jaypie_Ideal_Project_Structure.md
-prompts/templates/project-monorepo/.gitignore
+prompts/templates/project-monorepo/gitignore (rename to .gitignore when copying)
 prompts/templates/project-monorepo/.vscode/settings.json
 prompts/templates/project-monorepo/eslint.config.mjs
 prompts/templates/project-monorepo/package.json

package/prompts/templates/project-monorepo/gitignore

@@ -0,0 +1,11 @@
+.DS_Store
+.env
+.jaypie
+cdk.out
+context.out
+dist
+local
+Local
+LOCAL
+node_modules
+var