@markdy/mcp-server 0.8.25 → 0.8.27

package/README.md

@@ -51,6 +51,28 @@ Equip Claude Desktop, Cursor, Google Antigravity, and autonomous AI agents with
 }
 ```
 
+### Google Antigravity (`~/.gemini/antigravity/mcp_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "markdy": {
+      "command": "npx",
+      "args": ["-y", "@markdy/mcp-server"]
+    }
+  }
+}
+```
+
+---
+
+## 📖 Documentation & References
+
+- **Authoritative AI Agent Guide**: <https://markdy.com/AGENT.md>
+- **Human Documentation**: <https://markdy.com/docs/>
+- **Interactive Playground**: <https://markdy.com/playground/>
+- **LLM Index**: <https://markdy.com/llms.txt>
+
 ---
 
 ## License

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface ToolResult {
     isError?: boolean;
 }
 declare function handleValidateMarkdy(code: string, checkArchitecture?: boolean): ToolResult;
-declare function handleTranspileToMarkdy(source: string, format: "mermaid" | "docker-compose" | "k8s" | "terraform", title?: string): ToolResult;
+declare function handleTranspileToMarkdy(source: string, format: "mermaid" | "docker-compose" | "k8s" | "terraform" | "drawio", title?: string): Promise<ToolResult>;
 declare function handleExplainArchitecture(code: string): ToolResult;
 declare function handleGenerateMarkdyPrompt(userGoal: string): ToolResult;
 

package/dist/index.js

@@ -18,7 +18,8 @@ import {
   transpileMermaidToMarkdy,
   transpileDockerComposeToMarkdy,
   transpileKubernetesManifestsToMarkdy,
-  transpileTerraformStateToMarkdy
+  transpileTerraformStateToMarkdy,
+  transpileDrawioToMarkdy
 } from "@markdy/compat";
 function handleValidateMarkdy(code, checkArchitecture = true) {
   try {
@@ -43,7 +44,7 @@ function handleValidateMarkdy(code, checkArchitecture = true) {
       content: [{ type: "text", text: lines.join("\n") }]
     };
   } catch (error) {
-    const repairPrompt = analyzeAndBuildRepairPrompt(code);
+    const repairBundle = analyzeAndBuildRepairPrompt(code);
     return {
       isError: true,
       content: [
@@ -52,13 +53,13 @@ function handleValidateMarkdy(code, checkArchitecture = true) {
           text: `\u274C Parse Error: ${error.message}
 
 Suggested AI Healing Prompt:
-${repairPrompt}`
+${repairBundle.repairPrompt}`
         }
       ]
     };
   }
 }
-function handleTranspileToMarkdy(source, format, title = "Imported Scene") {
+async function handleTranspileToMarkdy(source, format, title = "Imported Scene") {
   try {
     let markdyCode = "";
     switch (format) {
@@ -74,6 +75,9 @@ function handleTranspileToMarkdy(source, format, title = "Imported Scene") {
       case "terraform":
         markdyCode = transpileTerraformStateToMarkdy(source, title);
         break;
+      case "drawio":
+        markdyCode = (await transpileDrawioToMarkdy(source, title)).code;
+        break;
       default:
         throw new Error(`Unsupported ingestion format: ${format}`);
     }
@@ -132,16 +136,17 @@ function handleExplainArchitecture(code) {
 }
 function handleGenerateMarkdyPrompt(userGoal) {
   const prompt = [
-    `You are an expert system architecture designer specializing in MarkdyScript DSL.`,
+    `You are an expert system architecture designer specializing in MarkdyScript 0.8+ syntax and DSL.`,
     `Goal: ${userGoal}`,
     ``,
-    `### Instructions:`,
-    `1. Use MarkdyScript 0.8+ syntax. Start with: \`scene "<Title>" theme=paper layout=LR\``,
-    `2. Define nodes using semantic types (e.g. \`browser client\`, \`gateway api_gw\`, \`service auth_svc\`, \`database pg_db\`, \`cache redis\`, \`queue kafka\`).`,
-    `3. Organize components in \`group <id> "<Label>": <members...>\` boundaries.`,
-    `4. Define animated traffic steps in \`beat <id> "<Description>":\``,
-    `5. Animate flows with \`show $nodes\`, \`client -> api_gw "request"\`, and \`api_gw -> auth_svc "verify"\`.`,
-    `6. Keep syntax clean and output ONLY valid MarkdyScript.`
+    `### Instructions & Authoritative Reference:`,
+    `1. Follow the canonical MarkdyScript 0.8+ syntax and specification hosted at: https://markdy.com/AGENT.md`,
+    `2. Start the scene with: \`scene "<Title>" theme=paper layout=LR\``,
+    `3. Define nodes using semantic types (e.g. \`browser client\`, \`gateway api_gw\`, \`service auth_svc\`, \`database pg_db\`, \`cache redis\`, \`queue kafka\`, \`worker worker\`).`,
+    `4. Organize components in \`group <id> "<Label>": <members...>\` boundaries.`,
+    `5. Animate flows with canonical operators: \`->\` (request), \`<-\` (response), \`~>\` (event), and \`--\` (dependency).`,
+    `6. Group narrative cues into \`beat <id> "<Description>":\` with \`show $nodes\`, \`glow\`, \`focus\`, \`frame\`.`,
+    `7. Keep syntax clean, do not invent unsupported directives, and output ONLY valid MarkdyScript.`
   ].join("\n");
   return {
     content: [{ type: "text", text: prompt }]
@@ -153,7 +158,7 @@ function createMarkdyMcpServer() {
   const server = new Server(
     {
       name: "markdy-mcp-server",
-      version: "0.8.20"
+      version: "0.8.26"
     },
     {
       capabilities: {
@@ -178,14 +183,14 @@ function createMarkdyMcpServer() {
         },
         {
           name: "transpile_to_markdy",
-          description: "Converts external infrastructure or diagram code (Mermaid, Docker Compose, Kubernetes manifests, or Terraform state) into animated MarkdyScript scenes.",
+          description: "Converts external infrastructure or diagram code (Mermaid, Docker Compose, Kubernetes manifests, Terraform state, or Draw.io XML) into animated MarkdyScript scenes.",
           inputSchema: {
             type: "object",
             properties: {
               source: { type: "string", description: "The source code or content to transpile." },
               format: {
                 type: "string",
-                enum: ["mermaid", "docker-compose", "k8s", "terraform"],
+                enum: ["mermaid", "docker-compose", "k8s", "terraform", "drawio"],
                 description: "The source format."
               },
               title: { type: "string", description: "Optional title for the resulting scene." }
@@ -228,7 +233,7 @@ function createMarkdyMcpServer() {
           safeArgs.checkArchitecture !== false
         );
       case "transpile_to_markdy":
-        return handleTranspileToMarkdy(
+        return await handleTranspileToMarkdy(
           String(safeArgs.source ?? ""),
           safeArgs.format,
           safeArgs.title ? String(safeArgs.title) : void 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdy/mcp-server",
-  "version": "0.8.25",
+  "version": "0.8.27",
   "description": "Model Context Protocol server for Markdy diagram validation, transpilation, and generation.",
   "license": "MIT",
   "type": "module",
@@ -16,8 +16,8 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.6.1",
-    "@markdy/compat": "0.8.25",
-    "@markdy/core": "0.8.25"
+    "@markdy/compat": "0.8.27",
+    "@markdy/core": "0.8.27"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",