@hellocrossman/mcp-sdk 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# @hellocrossman/mcp-sdk
+
+Turn your Express API into an MCP server with two lines of code.
+
+Your customers can access your business data and logic through AI assistants (Claude, ChatGPT, Cursor) instead of traditional UIs.
+
+## Install
+
+```bash
+npm install @hellocrossman/mcp-sdk
+```
+
+## Quick Start
+
+```typescript
+import express from 'express';
+import { createMcpServer } from '@hellocrossman/mcp-sdk';
+
+const app = express();
+
+// Your existing routes
+app.get('/api/customers', (req, res) => { /* ... */ });
+app.post('/api/orders', (req, res) => { /* ... */ });
+app.get('/api/orders/:id', (req, res) => { /* ... */ });
+
+// Add MCP in one line
+createMcpServer({ app });
+
+app.listen(3000);
+```
+
+That's it. Visit `localhost:3000/mcp` to see your auto-discovered tools.
+
+## How It Works
+
+1. **Auto-discovers your routes** -- Reads your Express router and finds all registered API routes
+2. **Generates MCP tools** -- Each route becomes a tool with a name, description, and input schema
+3. **Serves the MCP protocol** -- Creates a `/mcp` endpoint that speaks Streamable HTTP transport
+4. **Calls your actual routes** -- When a tool is invoked, it makes an internal HTTP request to your real endpoint, so all your auth, validation, and middleware still runs
+
+## Options
+
+```typescript
+createMcpServer({
+  app,                              // Your Express app (required)
+  path: '/mcp',                     // MCP endpoint path (default: '/mcp')
+  name: 'my-app',                   // Server name shown to AI clients (default: 'mcp-server')
+  version: '1.0.0',                 // Server version (default: '1.0.0')
+  description: 'My MCP server',     // Server description
+  routePrefix: '/api',              // Only expose routes starting with this (default: '/api')
+  excludeRoutes: ['/api/admin/*'],  // Hide specific routes (supports * wildcards)
+});
+```
+
+## What Gets Exposed
+
+| HTTP Method | Tool Prefix | Example Route | Tool Name |
+|---|---|---|---|
+| GET | `get_` | `/api/customers/:id` | `get_customers_by_id` |
+| POST | `create_` | `/api/orders` | `create_orders` |
+| PUT/PATCH | `update_` | `/api/orders/:id` | `update_orders_by_id` |
+| DELETE | `delete_` | `/api/orders/:id` | `delete_orders_by_id` |
+
+## Security
+
+- Only routes matching `routePrefix` are exposed (default: `/api`)
+- Use `excludeRoutes` to hide admin or internal endpoints
+- Tool execution goes through your existing Express middleware stack -- auth, rate limiting, validation all still apply
+- No direct database access -- the SDK only calls your routes
+
+## Connecting AI Clients
+
+Once your MCP server is running, AI assistants can connect to it:
+
+**Claude Desktop** -- Add to your MCP settings:
+```json
+{
+  "mcpServers": {
+    "my-app": {
+      "url": "https://yourapp.com/mcp"
+    }
+  }
+}
+```
+
+**Cursor** -- Add the MCP server URL in Cursor settings under MCP Servers.
+
+## Requirements
+
+- Node.js >= 18
+- Express >= 4
+- Zod >= 3
+
+## License
+
+MIT

package/dist/executor.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from "express";
+import type { DiscoveredTool } from "./types.js";
+export declare function executeTool(app: Express, tool: DiscoveredTool, args: Record<string, unknown>, port: number): Promise<string>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAiEjB"}

package/dist/executor.js

@@ -0,0 +1,63 @@
+import http from "http";
+export async function executeTool(app, tool, args, port) {
+    let path = tool.path;
+    for (const param of tool.params) {
+        const value = args[param];
+        if (value !== undefined && value !== null) {
+            path = path.replace(`:${param}`, String(value));
+        }
+    }
+    if (tool.method === "GET") {
+        const queryParts = [];
+        if (args.query)
+            queryParts.push(`q=${encodeURIComponent(String(args.query))}`);
+        if (args.limit)
+            queryParts.push(`limit=${encodeURIComponent(String(args.limit))}`);
+        if (queryParts.length > 0) {
+            path += `?${queryParts.join("&")}`;
+        }
+    }
+    const body = (tool.method === "POST" || tool.method === "PUT" || tool.method === "PATCH") && args.body
+        ? JSON.stringify(args.body)
+        : undefined;
+    return new Promise((resolve, reject) => {
+        const options = {
+            hostname: "127.0.0.1",
+            port,
+            path,
+            method: tool.method,
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                ...(body ? { "Content-Length": Buffer.byteLength(body) } : {}),
+            },
+        };
+        const req = http.request(options, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk;
+            });
+            res.on("end", () => {
+                try {
+                    const parsed = JSON.parse(data);
+                    resolve(JSON.stringify(parsed, null, 2));
+                }
+                catch {
+                    resolve(data);
+                }
+            });
+        });
+        req.on("error", (err) => {
+            reject(new Error(`Tool execution failed: ${err.message}`));
+        });
+        req.setTimeout(30000, () => {
+            req.destroy();
+            reject(new Error("Tool execution timed out"));
+        });
+        if (body) {
+            req.write(body);
+        }
+        req.end();
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createMcpServer } from "./server.js";
+export type { McpServerOptions, DiscoveredRoute, DiscoveredTool } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createMcpServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/introspect.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from "express";
+import type { DiscoveredRoute } from "./types.js";
+export declare function introspectExpressRoutes(app: Express, routePrefix?: string): DiscoveredRoute[];
+//# sourceMappingURL=introspect.d.ts.map

package/dist/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,OAAO,EACZ,WAAW,SAAS,GACnB,eAAe,EAAE,CAuDnB"}

package/dist/introspect.js

@@ -0,0 +1,55 @@
+export function introspectExpressRoutes(app, routePrefix = "/api") {
+    const routes = [];
+    const seen = new Set();
+    function extractRoutes(stack, basePath = "") {
+        if (!stack)
+            return;
+        for (const layer of stack) {
+            if (layer.route) {
+                const fullPath = basePath + layer.route.path;
+                if (!fullPath.startsWith(routePrefix))
+                    continue;
+                const methods = Object.keys(layer.route.methods).filter((m) => layer.route.methods[m]);
+                const params = extractParams(fullPath);
+                for (const method of methods) {
+                    const key = `${method.toUpperCase()}:${fullPath}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    routes.push({
+                        method: method.toUpperCase(),
+                        path: fullPath,
+                        params,
+                    });
+                }
+            }
+            else if ((layer.name === "router" || layer.handle?.stack) &&
+                layer.handle?.stack) {
+                let prefix = basePath;
+                if (layer.keys && layer.keys.length > 0) {
+                    // mounted router with path params
+                }
+                else if (layer.regexp) {
+                    const regStr = layer.regexp.toString();
+                    const match = regStr.match(/^\/\^\\(.+?)\\\/\?\(\?=\\\/\|\$\)\/i$/);
+                    if (match) {
+                        prefix = basePath + "/" + match[1].replace(/\\\//g, "/");
+                    }
+                }
+                extractRoutes(layer.handle.stack, prefix);
+            }
+        }
+    }
+    const router = app.router || app._router;
+    if (router && router.stack) {
+        extractRoutes(router.stack);
+    }
+    return routes;
+}
+function extractParams(path) {
+    const matches = path.match(/:([a-zA-Z_][a-zA-Z0-9_]*)/g);
+    if (!matches)
+        return [];
+    return matches.map((m) => m.slice(1));
+}
+//# sourceMappingURL=introspect.js.map

package/dist/introspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.js","sourceRoot":"","sources":["../src/introspect.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import type { McpServerOptions, DiscoveredTool } from "./types.js";
+export declare function createMcpServer(options: McpServerOptions): {
+    tools: DiscoveredTool[];
+    routes: import("./types.js").DiscoveredRoute[];
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGnE,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB;;;EAuKxD"}

package/dist/server.js

@@ -0,0 +1,141 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { randomUUID } from "crypto";
+import { introspectExpressRoutes } from "./introspect.js";
+import { generateToolsFromRoutes } from "./tool-generator.js";
+import { executeTool } from "./executor.js";
+import { z } from "zod";
+export function createMcpServer(options) {
+    const { app, path: mcpPath = "/mcp", name = "mcp-server", version = "1.0.0", description = "Auto-discovered MCP server", routePrefix = "/api", excludeRoutes = [], } = options;
+    const routes = introspectExpressRoutes(app, routePrefix);
+    const tools = generateToolsFromRoutes(routes, excludeRoutes);
+    const port = parseInt(process.env.PORT || "5000", 10);
+    console.log(`[mcp-sdk] Discovered ${routes.length} API routes`);
+    console.log(`[mcp-sdk] Generated ${tools.length} MCP tools:`);
+    tools.forEach((t) => {
+        console.log(`[mcp-sdk]   - ${t.name} (${t.method} ${t.path})`);
+    });
+    const sessions = new Map();
+    function buildMcpServer() {
+        const mcpServer = new McpServer({ name, version });
+        for (const tool of tools) {
+            const paramShape = {};
+            if (tool.inputSchema.properties && typeof tool.inputSchema.properties === "object") {
+                for (const [key, schema] of Object.entries(tool.inputSchema.properties)) {
+                    const isRequired = Array.isArray(tool.inputSchema.required) && tool.inputSchema.required.includes(key);
+                    let zodType;
+                    if (schema.type === "number") {
+                        zodType = z.number().describe(schema.description || key);
+                    }
+                    else if (schema.type === "object") {
+                        zodType = z.record(z.unknown()).describe(schema.description || key);
+                    }
+                    else {
+                        zodType = z.string().describe(schema.description || key);
+                    }
+                    if (!isRequired) {
+                        zodType = zodType.optional();
+                    }
+                    paramShape[key] = zodType;
+                }
+            }
+            mcpServer.tool(tool.name, tool.description, paramShape, async (args) => {
+                try {
+                    const result = await executeTool(app, tool, args, port);
+                    return {
+                        content: [{ type: "text", text: result }],
+                    };
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : "Unknown error";
+                    return {
+                        content: [{ type: "text", text: `Error: ${message}` }],
+                        isError: true,
+                    };
+                }
+            });
+        }
+        return mcpServer;
+    }
+    app.post(mcpPath, async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && sessions.has(sessionId)) {
+            const session = sessions.get(sessionId);
+            await session.transport.handleRequest(req, res, req.body);
+            return;
+        }
+        const isInitRequest = req.body && typeof req.body === "object" && req.body.method === "initialize";
+        if (!isInitRequest && !sessionId) {
+            res.status(400).json({
+                jsonrpc: "2.0",
+                error: { code: -32000, message: "Missing session ID. Send an initialize request first." },
+                id: null,
+            });
+            return;
+        }
+        try {
+            const mcpServer = buildMcpServer();
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+            });
+            await mcpServer.connect(transport);
+            transport.onclose = () => {
+                const sid = transport.sessionId;
+                if (sid)
+                    sessions.delete(sid);
+                mcpServer.close().catch(() => { });
+            };
+            await transport.handleRequest(req, res, req.body);
+            const sid = transport.sessionId;
+            if (sid) {
+                sessions.set(sid, { transport, server: mcpServer });
+            }
+        }
+        catch (error) {
+            console.error("[mcp-sdk] Error handling MCP request:", error);
+            if (!res.headersSent) {
+                res.status(500).json({ error: "MCP server error" });
+            }
+        }
+    });
+    app.get(mcpPath, (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && sessions.has(sessionId)) {
+            const session = sessions.get(sessionId);
+            session.transport.handleRequest(req, res).catch(() => {
+                res.status(500).json({ error: "SSE connection failed" });
+            });
+            return;
+        }
+        res.json({
+            name,
+            version,
+            description,
+            transport: "streamable-http",
+            endpoint: mcpPath,
+            toolCount: tools.length,
+            tools: tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                method: t.method,
+                path: t.path,
+            })),
+        });
+    });
+    app.delete(mcpPath, async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && sessions.has(sessionId)) {
+            const session = sessions.get(sessionId);
+            await session.transport.handleRequest(req, res, req.body);
+            sessions.delete(sessionId);
+            return;
+        }
+        res.status(404).json({ error: "Session not found" });
+    });
+    console.log(`[mcp-sdk] MCP endpoint available at ${mcpPath}`);
+    return {
+        tools,
+        routes,
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tool-generator.d.ts

@@ -0,0 +1,3 @@
+import type { DiscoveredRoute, DiscoveredTool } from "./types.js";
+export declare function generateToolsFromRoutes(routes: DiscoveredRoute[], excludeRoutes?: string[]): DiscoveredTool[];
+//# sourceMappingURL=tool-generator.d.ts.map

package/dist/tool-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-generator.d.ts","sourceRoot":"","sources":["../src/tool-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EAAE,EACzB,aAAa,GAAE,MAAM,EAAO,GAC3B,cAAc,EAAE,CAclB"}

package/dist/tool-generator.js

@@ -0,0 +1,119 @@
+export function generateToolsFromRoutes(routes, excludeRoutes = []) {
+    return routes
+        .filter((route) => {
+        return !excludeRoutes.some((pattern) => {
+            if (pattern.includes("*")) {
+                const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+                return regex.test(route.path);
+            }
+            return route.path === pattern;
+        });
+    })
+        .map((route) => routeToTool(route));
+}
+function routeToTool(route) {
+    const name = generateToolName(route.method, route.path);
+    const description = generateDescription(route.method, route.path);
+    const inputSchema = generateInputSchema(route);
+    return {
+        name,
+        description,
+        method: route.method,
+        path: route.path,
+        inputSchema,
+        params: route.params,
+    };
+}
+function generateToolName(method, path) {
+    const segments = path
+        .replace(/^\/api\/?/, "")
+        .split("/")
+        .filter(Boolean)
+        .map((seg) => {
+        if (seg.startsWith(":")) {
+            return "by_" + seg.slice(1);
+        }
+        return seg.replace(/[^a-zA-Z0-9]/g, "_");
+    });
+    const prefix = methodToPrefix(method);
+    const name = segments.join("_");
+    return `${prefix}_${name}`.toLowerCase().replace(/_+/g, "_");
+}
+function methodToPrefix(method) {
+    switch (method) {
+        case "GET":
+            return "get";
+        case "POST":
+            return "create";
+        case "PUT":
+        case "PATCH":
+            return "update";
+        case "DELETE":
+            return "delete";
+        default:
+            return method.toLowerCase();
+    }
+}
+function generateDescription(method, path) {
+    const segments = path
+        .replace(/^\/api\/?/, "")
+        .split("/")
+        .filter(Boolean);
+    const resource = segments
+        .filter((s) => !s.startsWith(":"))
+        .map((s) => s.replace(/-/g, " ").replace(/_/g, " "))
+        .join(" ");
+    const paramNames = segments
+        .filter((s) => s.startsWith(":"))
+        .map((s) => s.slice(1));
+    switch (method) {
+        case "GET":
+            if (paramNames.length > 0) {
+                return `Get ${resource} by ${paramNames.join(" and ")}`;
+            }
+            return `List or query ${resource}`;
+        case "POST":
+            return `Create a new ${resource}`;
+        case "PUT":
+        case "PATCH":
+            return `Update ${resource} by ${paramNames.join(" and ")}`;
+        case "DELETE":
+            return `Delete ${resource} by ${paramNames.join(" and ")}`;
+        default:
+            return `${method} ${resource}`;
+    }
+}
+function generateInputSchema(route) {
+    const properties = {};
+    const required = [];
+    for (const param of route.params) {
+        properties[param] = {
+            type: "string",
+            description: `The ${param} parameter`,
+        };
+        required.push(param);
+    }
+    if (route.method === "GET") {
+        properties["query"] = {
+            type: "string",
+            description: "Optional query/search string to filter results",
+        };
+        properties["limit"] = {
+            type: "number",
+            description: "Maximum number of results to return",
+        };
+    }
+    if (route.method === "POST" || route.method === "PUT" || route.method === "PATCH") {
+        properties["body"] = {
+            type: "object",
+            description: "The request body data to send",
+            additionalProperties: true,
+        };
+    }
+    return {
+        type: "object",
+        properties,
+        required: required.length > 0 ? required : undefined,
+    };
+}
+//# sourceMappingURL=tool-generator.js.map

package/dist/tool-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-generator.js","sourceRoot":"","sources":["../src/tool-generator.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+import type { Express } from "express";
+export interface McpServerOptions {
+    app: Express;
+    path?: string;
+    name?: string;
+    version?: string;
+    description?: string;
+    routePrefix?: string;
+    excludeRoutes?: string[];
+}
+export interface DiscoveredRoute {
+    method: string;
+    path: string;
+    params: string[];
+}
+export interface DiscoveredTool {
+    name: string;
+    description: string;
+    method: string;
+    path: string;
+    inputSchema: Record<string, unknown>;
+    params: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@hellocrossman/mcp-sdk",
+  "version": "0.1.0",
+  "description": "Turn your Express API into an MCP server with two lines of code. Auto-discovers routes, generates tools, and serves them over the MCP protocol.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "express",
+    "ai",
+    "tools",
+    "claude",
+    "chatgpt",
+    "cursor",
+    "api",
+    "sdk"
+  ],
+  "author": "HelloCrossman",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hellocrossman/mcp-sdk"
+  },
+  "homepage": "https://hellocrossman.com",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0",
+    "zod": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": false
+    },
+    "zod": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}