@coral-viz/mcp-server 0.2.3

package/LICENSE

@@ -0,0 +1,4 @@
+Copyright 2026 Coral contributors
+
+Licensed under the Apache License, Version 2.0. You may obtain a copy at
+https://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -0,0 +1,17 @@
+# @coral-viz/mcp-server 0.2.3
+
+General-purpose Coral diagram tools over MCP stdio:
+
+- `coral_generate` — heuristic description-to-diagram generation
+- `coral_validate` — shared Coral parser and GraphIR validation
+- `coral_convert` — Coral/Mermaid/DOT/PlantUML import with structured loss diagnostics and strict mode
+- `coral_layout` — recursive ELK geometry with absolute nested-node output
+- `coral_render` — deterministic SVG or standalone HTML; supplied complete positions are preserved
+- `coral_explain` — graph summary
+
+```bash
+npm run build -w @coral-viz/mcp-server
+node packages/mcp-server/dist/index.js
+```
+
+The server reports 0.2.3. Codebase analysis is not provided; Schooner owns that workflow.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Coral MCP Server
+ *
+ * Provides tools for diagram generation, validation, and conversion
+ * via the Model Context Protocol.
+ */
+export {};
+//# 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":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * Coral MCP Server
+ *
+ * Provides tools for diagram generation, validation, and conversion
+ * via the Model Context Protocol.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { generateTool, handleGenerate } from "./tools/generate.js";
+import { validateTool, handleValidate } from "./tools/validate.js";
+import { convertTool, handleConvert } from "./tools/convert.js";
+import { explainTool, handleExplain } from "./tools/explain.js";
+import { layoutTool, handleLayout } from "./tools/layout.js";
+import { renderTool, handleRender } from "./tools/render.js";
+const server = new Server({
+    name: "coral-mcp-server",
+    version: "0.2.3",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            generateTool,
+            validateTool,
+            convertTool,
+            layoutTool,
+            renderTool,
+            explainTool,
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "coral_generate":
+                return await handleGenerate(args);
+            case "coral_validate":
+                return await handleValidate(args);
+            case "coral_convert":
+                return await handleConvert(args);
+            case "coral_explain":
+                return await handleExplain(args);
+            case "coral_layout":
+                return await handleLayout(args);
+            case "coral_render":
+                return await handleRender(args);
+            default:
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unknown tool: ${name}`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Coral MCP Server running on stdio");
+}
+main().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/convert.d.ts

@@ -0,0 +1,59 @@
+/**
+ * coral_convert tool
+ *
+ * Convert between diagram formats (Mermaid, DOT, PlantUML, Coral).
+ */
+import { type Diagnostic } from "@coral-viz/language";
+export declare const convertTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            content: {
+                type: string;
+                description: string;
+            };
+            from: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            to: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            strict: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Detect the source format.
+ *
+ * One implementation, shared with the rest of the server, rather than the
+ * private copy this tool used to keep.
+ */
+export declare function detectFormat(source: string): "mermaid" | "dot" | "plantuml" | "coral";
+export declare function handleConvert(args: unknown): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    structuredContent: {
+        from: "mermaid" | "dot" | "plantuml" | "coral";
+        to: "json" | "coral";
+        nodeCount: number;
+        edgeCount: number;
+        diagnostics: Diagnostic[];
+    };
+    isError: boolean;
+}>;
+//# sourceMappingURL=convert.d.ts.map

package/dist/tools/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/tools/convert.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAOL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCvB,CAAC;AAUF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,OAAO,CAUrF;AA4BD,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO;;;;;;;;;;;;;GAsEhD"}

package/dist/tools/convert.js

@@ -0,0 +1,152 @@
+/**
+ * coral_convert tool
+ *
+ * Convert between diagram formats (Mermaid, DOT, PlantUML, Coral).
+ */
+import { z } from "zod";
+import { parse, parseMermaid, parseDot, parsePlantUml, printWithDiagnostics, } from "@coral-viz/language";
+export const convertTool = {
+    name: "coral_convert",
+    description: "Convert diagrams between formats. Supports Mermaid, Graphviz DOT, PlantUML to Coral, and Coral to other formats.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            content: {
+                type: "string",
+                description: "The diagram content to convert",
+            },
+            from: {
+                type: "string",
+                enum: ["mermaid", "dot", "plantuml", "coral", "auto"],
+                description: "Source format (use 'auto' to detect)",
+                default: "auto",
+            },
+            to: {
+                type: "string",
+                enum: ["coral", "json"],
+                description: "Target format",
+                default: "coral",
+            },
+            strict: {
+                type: "boolean",
+                description: "Fail the conversion when anything is lost, rather than reporting it and continuing",
+                default: false,
+            },
+        },
+        required: ["content"],
+    },
+};
+const ConvertArgsSchema = z.object({
+    content: z.string(),
+    from: z.enum(["mermaid", "dot", "plantuml", "coral", "auto"]).default("auto"),
+    to: z.enum(["coral", "json"]).default("coral"),
+    strict: z.boolean().default(false),
+});
+/**
+ * Detect the source format.
+ *
+ * One implementation, shared with the rest of the server, rather than the
+ * private copy this tool used to keep.
+ */
+export function detectFormat(source) {
+    const trimmed = source.trim();
+    if (/^@start/i.test(trimmed))
+        return "plantuml";
+    // Mermaid is checked first: `graph TD` also matches a naive DOT pattern.
+    if (/^(flowchart|sequenceDiagram|classDiagram|stateDiagram|erDiagram|timeline|block-beta|packet-beta|kanban|architecture-beta)\b/i.test(trimmed)) {
+        return "mermaid";
+    }
+    if (/^graph\s+(TB|TD|BT|RL|LR)\b/i.test(trimmed))
+        return "mermaid";
+    if (/^(strict\s+)?(di)?graph\b[^{]*\{/i.test(trimmed))
+        return "dot";
+    return "coral";
+}
+function parseAs(format, content) {
+    switch (format) {
+        case "mermaid":
+            return parseMermaid(content);
+        case "dot":
+            return parseDot(content);
+        case "plantuml":
+            return parsePlantUml(content);
+        default:
+            return parse(content);
+    }
+}
+/** Human-readable notes, so a lossy conversion says what it lost. */
+function formatNotes(result) {
+    const notes = result.diagnostics.filter((d) => d.severity !== "error");
+    if (notes.length === 0)
+        return "";
+    const lines = notes.map((d) => {
+        const where = d.position ? ` line ${d.position.line}:` : "";
+        const source = d.source ? ` \`${d.source}\`` : "";
+        return `- ${d.severity} [${d.code}]${where}${source}\n  ${d.message}`;
+    });
+    return `\n\n## Conversion notes\n${lines.join("\n")}`;
+}
+export async function handleConvert(args) {
+    const { content, from, to, strict } = ConvertArgsSchema.parse(args);
+    const sourceFormat = from === "auto" ? detectFormat(content) : from;
+    const result = parseAs(sourceFormat, content);
+    if (!result.graph || result.graph.nodes.length === 0 || !result.success) {
+        const why = result.errors[0]?.message ?? "no nodes were produced";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Could not convert from ${sourceFormat}: ${why}` + formatNotes(result),
+                },
+            ],
+            structuredContent: {
+                from: sourceFormat,
+                to,
+                nodeCount: result.graph?.nodes.length ?? 0,
+                edgeCount: result.graph?.edges.length ?? 0,
+                diagnostics: result.diagnostics,
+            },
+            isError: true,
+        };
+    }
+    const graph = result.graph;
+    const printed = to === "coral" ? printWithDiagnostics(graph) : undefined;
+    const diagnostics = [...result.diagnostics, ...(printed?.diagnostics ?? [])];
+    const combined = { diagnostics };
+    const lossy = diagnostics.some((d) => d.severity !== "error");
+    if (strict && lossy) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Refusing a lossy conversion from ${sourceFormat} in strict mode.` +
+                        formatNotes(combined),
+                },
+            ],
+            structuredContent: {
+                from: sourceFormat,
+                to,
+                nodeCount: graph.nodes.length,
+                edgeCount: graph.edges.length,
+                diagnostics,
+            },
+            isError: true,
+        };
+    }
+    const output = to === "json" ? JSON.stringify(graph, null, 2) : printed.text;
+    const summary = `Converted from ${sourceFormat} to ${to}: ` +
+        `${graph.nodes.length} nodes, ${graph.edges.length} edges` +
+        (lossy ? `, ${diagnostics.filter((d) => d.severity !== "error").length} notes` : "");
+    return {
+        content: [{ type: "text", text: `${summary}\n\n${output}${formatNotes(combined)}` }],
+        structuredContent: {
+            from: sourceFormat,
+            to,
+            nodeCount: graph.nodes.length,
+            edgeCount: graph.edges.length,
+            diagnostics,
+        },
+        isError: !result.success,
+    };
+}
+//# sourceMappingURL=convert.js.map

package/dist/tools/convert.js.map

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

package/dist/tools/explain.d.ts

@@ -0,0 +1,36 @@
+/**
+ * coral_explain tool
+ *
+ * Generate natural language explanations of diagrams.
+ */
+export declare const explainTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            content: {
+                type: string;
+                description: string;
+            };
+            level: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            focus: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleExplain(args: unknown): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/tools/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;CAwBvB,CAAC;AAqZF,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO;;;;;GA2ChD"}