@jaypie/mcp 0.1.2 → 0.1.3

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

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

package/dist/index.d.ts

@@ -1,4 +1,3 @@
 #!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-declare const server: McpServer;
-export { server };
+export { createMcpServer } from "./createMcpServer.js";
+export { mcpExpressHandler, type McpExpressHandlerOptions, } from "./mcpExpressHandler.js";

package/dist/index.js

@@ -1,23 +1,17 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
 import matter from 'gray-matter';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { randomUUID } from 'crypto';
 
-// Version will be injected during build
-const version = "0.0.0";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const PROMPTS_PATH = path.join(__dirname, "..", "prompts");
-const server = new McpServer({
-    name: "jaypie",
-    version,
-}, {
-    capabilities: {},
-});
 async function parseMarkdownFile(filePath) {
     try {
         const content = await fs.readFile(filePath, "utf-8");
@@ -52,76 +46,145 @@ function formatPromptListItem(prompt) {
         return `* ${filename}`;
     }
 }
-server.tool("list_prompts", "Returns a bulleted list of all .md files in the prompts directory with their descriptions and requirements", {}, async () => {
-    try {
-        const files = await fs.readdir(PROMPTS_PATH);
-        const mdFiles = files.filter((file) => file.endsWith(".md"));
-        const prompts = await Promise.all(mdFiles.map((file) => parseMarkdownFile(path.join(PROMPTS_PATH, file))));
-        const formattedList = prompts.map(formatPromptListItem).join("\n");
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: formattedList || "No .md files found in the prompts directory.",
-                },
-            ],
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error listing prompts: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ],
-        };
-    }
-});
-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 }) => {
-    try {
-        const filePath = path.join(PROMPTS_PATH, filename);
-        const content = await fs.readFile(filePath, "utf-8");
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: content,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        if (error.code === "ENOENT") {
+/**
+ * Creates and configures an MCP server instance with Jaypie tools
+ * @param version - The version string for the server
+ * @returns Configured MCP server instance
+ */
+function createMcpServer(version = "0.0.0") {
+    const server = new McpServer({
+        name: "jaypie",
+        version,
+    }, {
+        capabilities: {},
+    });
+    server.tool("list_prompts", "Returns a bulleted list of all .md files in the prompts directory with their descriptions and requirements", {}, async () => {
+        try {
+            const files = await fs.readdir(PROMPTS_PATH);
+            const mdFiles = files.filter((file) => file.endsWith(".md"));
+            const prompts = await Promise.all(mdFiles.map((file) => parseMarkdownFile(path.join(PROMPTS_PATH, file))));
+            const formattedList = prompts.map(formatPromptListItem).join("\n");
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Error: Prompt file "${filename}" not found in prompts directory`,
+                        text: formattedList || "No .md files found in the prompts directory.",
                     },
                 ],
             };
         }
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Error reading prompt file: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ],
-        };
-    }
-});
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing prompts: ${error instanceof Error ? error.message : "Unknown error"}`,
+                    },
+                ],
+            };
+        }
+    });
+    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 }) => {
+        try {
+            const filePath = path.join(PROMPTS_PATH, filename);
+            const content = await fs.readFile(filePath, "utf-8");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: content,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Error: Prompt file "${filename}" not found in prompts directory`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error reading prompt file: ${error instanceof Error ? error.message : "Unknown error"}`,
+                    },
+                ],
+            };
+        }
+    });
+    return server;
+}
+
+// Version will be injected during build
+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
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { mcpExpressHandler } from '@jaypie/mcp';
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * app.use('/mcp', mcpExpressHandler({
+ *   version: '1.0.0',
+ *   enableSessions: true
+ * }));
+ *
+ * app.listen(3000, () => {
+ *   console.log('MCP server running on http://localhost:3000/mcp');
+ * });
+ * ```
+ */
+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);
+    return async (req, res) => {
+        try {
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            if (!res.headersSent) {
+                res.status(500).json({
+                    error: "Internal server error",
+                    message: error instanceof Error ? error.message : "Unknown error",
+                });
+            }
+        }
+    };
+}
+
+// Version will be injected during build
+const version = "0.0.0";
 async function main() {
+    const server = createMcpServer(version);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Server is running on stdio
 }
-main();
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
 
-export { server };
+export { createMcpServer, mcpExpressHandler };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport matter from \"gray-matter\";\n// Version will be injected during build\nconst version = \"0.0.0\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\nconst PROMPTS_PATH = path.join(__dirname, \"..\", \"prompts\");\n\nconst server = new McpServer(\n  {\n    name: \"jaypie\",\n    version,\n  },\n  {\n    capabilities: {},\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\nserver.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) => parseMarkdownFile(path.join(PROMPTS_PATH, file))),\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\nserver.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\nasync function main() {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  // Server is running on stdio\n}\n\nmain();\n\nexport { server };\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 \"fs/promises\";\nimport * as path from \"path\";\nimport { fileURLToPath } from \"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 \"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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"}

package/dist/mcpExpressHandler.d.ts

@@ -0,0 +1,49 @@
+import { Request, Response } from "express";
+/**
+ * Options for configuring the MCP Express handler
+ */
+export interface McpExpressHandlerOptions {
+    /**
+     * Version string for the MCP server
+     */
+    version?: string;
+    /**
+     * Whether to enable session management (stateful mode)
+     * Default: true
+     */
+    enableSessions?: boolean;
+    /**
+     * Custom session ID generator function
+     */
+    sessionIdGenerator?: () => string;
+    /**
+     * Enable JSON responses instead of SSE streaming
+     * Default: false
+     */
+    enableJsonResponse?: boolean;
+}
+/**
+ * Creates an Express handler for the Jaypie MCP server using HTTP transport
+ *
+ * @param options - Configuration options for the handler
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { mcpExpressHandler } from '@jaypie/mcp';
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * app.use('/mcp', mcpExpressHandler({
+ *   version: '1.0.0',
+ *   enableSessions: true
+ * }));
+ *
+ * app.listen(3000, () => {
+ *   console.log('MCP server running on http://localhost:3000/mcp');
+ * });
+ * ```
+ */
+export declare function mcpExpressHandler(options?: McpExpressHandlerOptions): (req: Request, res: Response) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Jaypie MCP server",
   "license": "MIT",
   "author": "Finlayson Studio",
@@ -36,9 +36,12 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/express": "^5.0.3",
+    "express": "^5.1.0",
     "shx": "^0.3.4"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "gitHead": "cdfbc2d54bb745018c7147cc0bd694aae8614565"
 }