@opencodereview/mcp-server 1.0.1 → 1.0.2

package/dist/index.d.ts

@@ -1,2 +1,35 @@
 #!/usr/bin/env node
-export {};
+export declare function createSandboxServer(): import("@modelcontextprotocol/sdk/server").Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;

package/dist/index.js

@@ -1,94 +1,57 @@
 #!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { createServer } from "./server.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { scanDirectorySchema, scanDiffSchema, handleScanDirectory, handleScanDiff, } from "./tools/scan.js";
-import { explainIssueSchema, handleExplainIssue, } from "./tools/explain.js";
-import { healCodeSchema, handleHealCode, } from "./tools/heal.js";
-const server = new Server({ name: "open-code-review", version: "1.0.0" }, { capabilities: { tools: {} } });
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools: [
-        {
-            name: "scan_directory",
-            description: "Scan a directory for AI-generated code quality issues. Detects hallucinated imports, phantom packages, stale APIs, security anti-patterns, and more. Supports TypeScript, JavaScript, Python, Java, Go, and Kotlin.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    path: { type: "string", description: "Directory path to scan" },
-                    level: { type: "string", enum: ["L1", "L2", "L3"], default: "L1", description: "SLA level: L1 (fast structural), L2 (standard + local AI), L3 (deep + remote AI)" },
-                    languages: { type: "string", description: "Comma-separated languages (e.g. 'typescript,python'). Auto-detect if omitted." },
-                },
-                required: ["path"],
-            },
-        },
-        {
-            name: "scan_diff",
-            description: "Scan git diff between two branches for code quality issues. Ideal for PR/MR review — only analyzes changed files and lines.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    base: { type: "string", description: "Base branch (e.g. 'origin/main')" },
-                    head: { type: "string", description: "Head branch (e.g. 'HEAD')" },
-                    path: { type: "string", description: "Repository path" },
-                    level: { type: "string", enum: ["L1", "L2", "L3"], default: "L1", description: "SLA level" },
-                },
-                required: ["base", "head", "path"],
-            },
-        },
-        {
-            name: "explain_issue",
-            description: "Explain a code quality issue detected by OCR. Returns detailed explanation, category context, and fix guidance for the AI agent to act on.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    issue: { type: "string", description: "The issue description to explain" },
-                    file: { type: "string", description: "File path where the issue was found" },
-                    line: { type: "number", description: "Line number" },
-                    severity: { type: "string", description: "Severity: critical/high/medium/low/info" },
-                    category: { type: "string", description: "Issue category" },
-                    suggestion: { type: "string", description: "Auto-generated fix suggestion" },
-                },
-                required: ["issue"],
-            },
-        },
-        {
-            name: "heal_code",
-            description: "Load a file's source code and prepare a repair prompt for the AI agent. The agent (you) should then apply the fix based on the issue description and suggestion. Returns the file content along with the repair context.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    path: { type: "string", description: "File path to heal" },
-                    issue: { type: "string", description: "Issue description to fix" },
-                    suggestion: { type: "string", description: "Suggested fix from OCR scan" },
-                },
-                required: ["path", "issue"],
-            },
-        },
-    ],
-}));
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    switch (name) {
-        case "scan_directory": {
-            const parsed = scanDirectorySchema.parse(args);
-            return handleScanDirectory(parsed);
-        }
-        case "scan_diff": {
-            const parsed = scanDiffSchema.parse(args);
-            return handleScanDiff(parsed);
-        }
-        case "explain_issue": {
-            const parsed = explainIssueSchema.parse(args);
-            return handleExplainIssue(parsed);
-        }
-        case "heal_code": {
-            const parsed = healCodeSchema.parse(args);
-            return handleHealCode(parsed);
-        }
-        default:
-            throw new Error(`Unknown tool: ${name}`);
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+const server = createServer();
+export function createSandboxServer() {
+    return server;
+}
+const transport = process.env.TRANSPORT || "stdio";
+if (process.env.NODE_ENV !== "test" && process.env.SMITHERY !== "true") {
+    if (transport === "http") {
+        import("node:http").then(({ createServer }) => {
+            const httpServer = createServer(async (req, res) => {
+                // Only handle /mcp path
+                if (req.url !== "/mcp") {
+                    res.writeHead(404);
+                    res.end("Not Found. MCP endpoint is at /mcp");
+                    return;
+                }
+                // Collect request body for POST requests
+                const bodyChunks = [];
+                req.on("data", (chunk) => bodyChunks.push(chunk));
+                req.on("end", async () => {
+                    let parsedBody;
+                    if (req.method === "POST" && bodyChunks.length > 0) {
+                        try {
+                            parsedBody = JSON.parse(Buffer.concat(bodyChunks).toString());
+                        }
+                        catch {
+                            parsedBody = undefined;
+                        }
+                    }
+                    const httpTransport = new StreamableHTTPServerTransport({
+                        sessionIdGenerator: undefined,
+                    });
+                    httpTransport.onclose = () => {
+                        // Session closed
+                    };
+                    await server.connect(httpTransport);
+                    await httpTransport.handleRequest(req, res, parsedBody);
+                });
+            });
+            const port = parseInt(process.env.PORT || "3000", 10);
+            httpServer.listen(port, () => {
+                console.error(`MCP HTTP server listening on http://localhost:${port}/mcp`);
+            });
+        });
     }
-});
-const transport = new StdioServerTransport();
-await server.connect(transport);
+    else {
+        const stdioTransport = new StdioServerTransport();
+        server.connect(stdioTransport).catch((err) => {
+            console.error("Failed to connect MCP server:", err);
+            process.exit(1);
+        });
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CACtB,sBAAsB,EACtB,KAAK,IAAI,EAAE,CAAC,CAAC;IACX,KAAK,EAAE;QACL;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,qNAAqN;YAClO,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;oBAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,kFAAkF,EAAE;oBACnK,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+EAA+E,EAAE;iBAC5H;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,6HAA6H;YAC1I,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBACzE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;oBAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;oBACxD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE;iBAC7F;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aACnC;SACF;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,4IAA4I;YACzJ,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC1E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;oBAC5E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;oBACpD,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;oBACpF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;oBAC3D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;iBAC7E;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;SACF;QACD;YACE,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,0NAA0N;YACvO,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;oBAC1D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;oBAClE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;iBAC3E;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;aAC5B;SACF;KACF;CACF,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,iBAAiB,CACtB,qBAAqB,EACrB,KAAK,EAAE,OAAO,EAAE,EAAE;IAChB,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,CACF,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAE9B,MAAM,UAAU,mBAAmB;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC;AAEnD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;IACvE,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE;YAC5C,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBACjD,wBAAwB;gBACxB,IAAI,GAAG,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;oBACvB,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;oBACnB,GAAG,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;oBAC9C,OAAO;gBACT,CAAC;gBAED,yCAAyC;gBACzC,MAAM,UAAU,GAAa,EAAE,CAAC;gBAChC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC1D,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE;oBACvB,IAAI,UAAmB,CAAC;oBACxB,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACnD,IAAI,CAAC;4BACH,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;wBAChE,CAAC;wBAAC,MAAM,CAAC;4BACP,UAAU,GAAG,SAAS,CAAC;wBACzB,CAAC;oBACH,CAAC;oBAED,MAAM,aAAa,GAAG,IAAI,6BAA6B,CAAC;wBACtD,kBAAkB,EAAE,SAAS;qBAC9B,CAAC,CAAC;oBAEH,aAAa,CAAC,OAAO,GAAG,GAAG,EAAE;wBAC3B,iBAAiB;oBACnB,CAAC,CAAC;oBAEF,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;oBACpC,MAAM,aAAa,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;gBAC1D,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;YACtD,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;gBAC3B,OAAO,CAAC,KAAK,CAAC,iDAAiD,IAAI,MAAM,CAAC,CAAC;YAC7E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACpD,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function createServer(): Server;

package/dist/server.js

@@ -0,0 +1,121 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { scanDirectorySchema, scanDiffSchema, handleScanDirectory, handleScanDiff, } from "./tools/scan.js";
+import { explainIssueSchema, handleExplainIssue, } from "./tools/explain.js";
+import { healCodeSchema, handleHealCode, } from "./tools/heal.js";
+export function createServer() {
+    const server = new Server({ name: "open-code-review", version: "1.0.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "scan_directory",
+                description: "Scan a directory for AI-generated code quality issues. Detects hallucinated imports, phantom packages, stale APIs, security anti-patterns, and more. Supports TypeScript, JavaScript, Python, Java, Go, and Kotlin.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "Directory path to scan" },
+                        level: {
+                            type: "string",
+                            enum: ["L1", "L2", "L3"],
+                            default: "L1",
+                            description: "SLA level: L1 (fast structural), L2 (standard + local AI), L3 (deep + remote AI)",
+                        },
+                        languages: {
+                            type: "string",
+                            description: "Comma-separated languages (e.g. 'typescript,python'). Auto-detect if omitted.",
+                        },
+                    },
+                    required: ["path"],
+                },
+            },
+            {
+                name: "scan_diff",
+                description: "Scan git diff between two branches for code quality issues. Ideal for PR/MR review — only analyzes changed files and lines.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        base: { type: "string", description: "Base branch (e.g. 'origin/main')" },
+                        head: { type: "string", description: "Head branch (e.g. 'HEAD')" },
+                        path: { type: "string", description: "Repository path" },
+                        level: {
+                            type: "string",
+                            enum: ["L1", "L2", "L3"],
+                            default: "L1",
+                            description: "SLA level",
+                        },
+                    },
+                    required: ["base", "head", "path"],
+                },
+            },
+            {
+                name: "explain_issue",
+                description: "Explain a code quality issue detected by OCR. Returns detailed explanation, category context, and fix guidance for the AI agent to act on.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        issue: {
+                            type: "string",
+                            description: "The issue description to explain",
+                        },
+                        file: {
+                            type: "string",
+                            description: "File path where the issue was found",
+                        },
+                        line: { type: "number", description: "Line number" },
+                        severity: {
+                            type: "string",
+                            description: "Severity: critical/high/medium/low/info",
+                        },
+                        category: { type: "string", description: "Issue category" },
+                        suggestion: {
+                            type: "string",
+                            description: "Auto-generated fix suggestion",
+                        },
+                    },
+                    required: ["issue"],
+                },
+            },
+            {
+                name: "heal_code",
+                description: "Load a file's source code and prepare a repair prompt for the AI agent. The agent (you) should then apply the fix based on the issue description and suggestion. Returns the file content along with the repair context.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: { type: "string", description: "File path to heal" },
+                        issue: { type: "string", description: "Issue description to fix" },
+                        suggestion: {
+                            type: "string",
+                            description: "Suggested fix from OCR scan",
+                        },
+                    },
+                    required: ["path", "issue"],
+                },
+            },
+        ],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case "scan_directory": {
+                const parsed = scanDirectorySchema.parse(args);
+                return handleScanDirectory(parsed);
+            }
+            case "scan_diff": {
+                const parsed = scanDiffSchema.parse(args);
+                return handleScanDiff(parsed);
+            }
+            case "explain_issue": {
+                const parsed = explainIssueSchema.parse(args);
+                return handleExplainIssue(parsed);
+            }
+            case "heal_code": {
+                const parsed = healCodeSchema.parse(args);
+                return handleHealCode(parsed);
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    });
+    return server;
+}
+//# 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/worker.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    fetch(request: Request): Promise<Response>;
+};
+export default _default;

package/dist/worker.js

@@ -0,0 +1,123 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { z } from "zod";
+// ── explain_issue tool (no fs dependency) ──
+const CATEGORY_EXPLANATIONS = {
+    "hallucinated-import": "The code imports a package that does not exist in the npm registry. This is a common AI hallucination — the model invented a plausible-sounding package name that has never been published. Remove the import and replace with a real package, or implement the functionality inline.",
+    "phantom-package": "A dependency is declared in package.json but never actually imported or used anywhere in the source code. This bloats the install size and may indicate an AI added an unnecessary dependency.",
+    "stale-api": "The code calls an API or uses a function signature that has been deprecated or removed in the current version of the library. Check the library's changelog and migration guide for the replacement.",
+    "context-break": "The code contains logic that appears inconsistent with the surrounding context — possibly caused by an AI losing track of what it was building mid-generation. Review the surrounding code for coherence.",
+    duplication: "Significant code duplication detected. This may indicate the AI copy-pasted code blocks without abstracting shared logic. Consider extracting a shared function or utility.",
+    "security-pattern": "A potential security anti-pattern was detected (e.g., hardcoded secrets, eval usage, SQL injection risk, path traversal). This requires immediate review.",
+    overengineering: "The code is unnecessarily complex for what it does. AI models tend to add extra abstraction layers, generic types, or design patterns that aren't needed. Simplify the implementation.",
+};
+const explainIssueSchema = z.object({
+    issue: z.string().describe("The issue description to explain"),
+    file: z.string().optional().describe("File path where the issue was found"),
+    line: z.number().optional().describe("Line number where the issue was found"),
+    severity: z
+        .string()
+        .optional()
+        .describe("Issue severity (critical/high/medium/low/info)"),
+    category: z.string().optional().describe("Issue category"),
+    suggestion: z
+        .string()
+        .optional()
+        .describe("Auto-generated fix suggestion"),
+});
+async function handleExplainIssue(args) {
+    const categoryExplanation = args.category
+        ? CATEGORY_EXPLANATIONS[args.category]
+        : null;
+    const explanation = {
+        issue: args.issue,
+        file: args.file ?? null,
+        line: args.line ?? null,
+        severity: args.severity ?? null,
+        category: args.category ?? null,
+        suggestion: args.suggestion ?? null,
+        categoryExplanation,
+        analysis: `This is a ${args.severity ?? "unknown"} severity issue in the "${args.category ?? "uncategorized"}" category. ${categoryExplanation ?? "Review the flagged code and consider the suggestion for resolution."}`,
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(explanation, null, 2),
+            },
+        ],
+    };
+}
+// ── MCP Server setup ──
+function createCloudflareServer() {
+    const server = new Server({ name: "open-code-review", version: "1.0.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: "explain_issue",
+                description: "Explain a code quality issue detected by Open Code Review (OCR). Returns detailed explanation, category context, and fix guidance for the AI agent to act on.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        issue: {
+                            type: "string",
+                            description: "The issue description to explain",
+                        },
+                        file: {
+                            type: "string",
+                            description: "File path where the issue was found",
+                        },
+                        line: { type: "number", description: "Line number" },
+                        severity: {
+                            type: "string",
+                            description: "Severity: critical/high/medium/low/info",
+                        },
+                        category: { type: "string", description: "Issue category" },
+                        suggestion: {
+                            type: "string",
+                            description: "Auto-generated fix suggestion",
+                        },
+                    },
+                    required: ["issue"],
+                },
+            },
+        ],
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case "explain_issue": {
+                const parsed = explainIssueSchema.parse(args);
+                return handleExplainIssue(parsed);
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    });
+    return server;
+}
+// ── Worker fetch handler ──
+const mcpServer = createCloudflareServer();
+export default {
+    async fetch(request) {
+        const url = new URL(request.url);
+        // Health check
+        if (url.pathname === "/health") {
+            return new Response(JSON.stringify({ status: "ok", service: "open-code-review-mcp" }), {
+                headers: { "Content-Type": "application/json" },
+            });
+        }
+        // MCP endpoint
+        if (url.pathname === "/mcp") {
+            const transport = new WebStandardStreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+            });
+            transport.onclose = () => { };
+            await mcpServer.connect(transport);
+            return transport.handleRequest(request);
+        }
+        return new Response("Not Found. MCP endpoint is at /mcp", { status: 404 });
+    },
+};
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencodereview/mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP Server for Open Code Review - AI code quality gate for Claude Desktop, Cursor, Windsurf, VS Code Copilot",
   "type": "module",
   "main": "./dist/index.js",