@jaypie/mcp 0.1.4 → 0.1.6

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/index.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
 import matter from 'gray-matter';
 import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { randomUUID } from 'node:crypto';
@@ -131,7 +132,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
@@ -141,7 +142,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
  * }));
@@ -151,14 +153,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);
@@ -176,14 +178,56 @@ function mcpExpressHandler(options = {}) {
 
 // Version will be injected during build
 const version = "0.0.0";
+let server = null;
+let isShuttingDown = false;
+async function gracefulShutdown(exitCode = 0) {
+    if (isShuttingDown) {
+        return;
+    }
+    isShuttingDown = true;
+    try {
+        if (server) {
+            await server.close();
+        }
+    }
+    catch (error) {
+        // Ignore errors during shutdown
+    }
+    finally {
+        process.exit(exitCode);
+    }
+}
 async function main() {
-    const server = createMcpServer(version);
+    server = createMcpServer(version);
     const transport = new StdioServerTransport();
     await server.connect(transport);
+    // Handle process termination signals
+    process.on("SIGINT", () => gracefulShutdown(0));
+    process.on("SIGTERM", () => 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")) {
+            gracefulShutdown(0);
+        }
+    });
+    process.stdout.on("error", (error) => {
+        if (error.message?.includes("EPIPE")) {
+            gracefulShutdown(0);
+        }
+    });
     // Server is running on stdio
 }
-if (import.meta.url === `file://${process.argv[1]}`) {
-    main();
+// Only run main() if this module is executed directly (not imported)
+// This handles npx and symlinks in node_modules/.bin correctly
+if (process.argv[1]) {
+    const realPath = realpathSync(process.argv[1]);
+    const realPathAsUrl = pathToFileURL(realPath).href;
+    if (import.meta.url === realPathAsUrl) {
+        main().catch((error) => {
+            console.error("Fatal error:", error);
+            process.exit(1);
+        });
+    }
 }
 
 export { createMcpServer, mcpExpressHandler };

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 { 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\nif (import.meta.url === `file://${process.argv[1]}`) {\n  main();\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\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 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\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  try {\n    if (server) {\n      await server.close();\n    }\n  } catch (error) {\n    // Ignore errors during shutdown\n  } finally {\n    process.exit(exitCode);\n  }\n}\n\nasync function main() {\n  server = createMcpServer(version);\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  // Handle process termination signals\n  process.on(\"SIGINT\", () => gracefulShutdown(0));\n  process.on(\"SIGTERM\", () => gracefulShutdown(0));\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      gracefulShutdown(0);\n    }\n  });\n\n  process.stdout.on(\"error\", (error) => {\n    if (error.message?.includes(\"EPIPE\")) {\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      console.error(\"Fatal error:\", error);\n      process.exit(1);\n    });\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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"}

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.4",
+  "version": "0.1.6",
   "description": "Jaypie MCP server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/finlaysonstudio/jaypie"
+  },
   "license": "MIT",
   "author": "Finlayson Studio",
   "type": "module",
@@ -41,5 +45,6 @@
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "4d7e735fac6495df0dbbc405f53e9d4113095cc6"
 }