@graph-ir/mcp-server 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Graph-IR Tools contributors
+
+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/README.md

@@ -0,0 +1,105 @@
+# @graph-ir/mcp-server
+
+MCP (Model Context Protocol) server for Graph-IR validation, generation, visualization, and layout.
+
+## Installation
+
+```bash
+npm install @graph-ir/mcp-server
+```
+
+## Usage with Claude Code
+
+Add to your Claude Code configuration:
+
+```bash
+claude mcp add graph-ir-tools -- node /home/coreyt/projects/graph-ir-tools/packages/mcp-server/dist/index.js
+```
+
+Or add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "graph-ir-tools": {
+      "command": "node",
+      "args": ["/home/coreyt/projects/graph-ir-tools/packages/mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### validate_ir
+
+Validate Graph-IR JSON against schema and semantic rules.
+
+**Input:**
+- `ir` (string, required): Graph-IR JSON string
+- `strict` (boolean): Treat warnings as errors
+
+**Output:**
+- `valid`: Whether the IR is valid
+- `errors`: Array of error objects
+- `warnings`: Array of warning objects
+- `stats`: Node and edge counts
+
+### generate_ir
+
+Generate Graph-IR from natural language description.
+
+**Input:**
+- `description` (string, required): Natural language description
+- `style` (string): Generation style (default, compact, detailed)
+
+**Output:**
+- `success`: Whether generation succeeded
+- `ir`: Generated Graph-IR object
+- `notes`: Generation notes
+
+### visualize_ir
+
+Generate ASCII visualization of Graph-IR.
+
+**Input:**
+- `ir` (string, required): Graph-IR JSON string
+- `style` (string): Visualization style (box, compact, tree)
+
+**Output:**
+- `success`: Whether visualization succeeded
+- `visualization`: ASCII art string
+
+### layout_ir
+
+Compute graph layout using ELK algorithms.
+
+**Input:**
+- `ir` (string, required): Graph-IR JSON string
+- `algorithm` (string): Layout algorithm (layered, force, mrtree, box, stress)
+- `options` (object): Additional layout options
+
+**Output:**
+- `success`: Whether layout succeeded
+- `ir`: Graph-IR with layout coordinates added
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Start server (for debugging)
+npm start
+```
+
+## Related
+
+- [Graph-IR Specification](../../specs/graph-ir/)
+- [CONSOLIDATION-PLAN.md](../../CONSOLIDATION-PLAN.md)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+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 { validateIR } from './tools/validate.js';
+import { generateIR } from './tools/generate.js';
+import { visualizeIR } from './tools/visualize.js';
+import { layoutIR } from './tools/layout.js';
+import { listSymbols } from './tools/list-symbols.js';
+import { listNotations } from './tools/list-notations.js';
+import { validateNotation } from './tools/validate-notation.js';
+const server = new Server({
+    name: 'graph-ir-tools',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: 'validate_ir',
+            description: 'Validate Graph-IR JSON against schema and semantic rules',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ir: {
+                        type: 'string',
+                        description: 'Graph-IR JSON string to validate',
+                    },
+                    strict: {
+                        type: 'boolean',
+                        description: 'Treat warnings as errors',
+                        default: false,
+                    },
+                },
+                required: ['ir'],
+            },
+        },
+        {
+            name: 'generate_ir',
+            description: 'Generate Graph-IR from a natural language description',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    description: {
+                        type: 'string',
+                        description: 'Natural language description of the graph',
+                    },
+                    style: {
+                        type: 'string',
+                        enum: ['default', 'compact', 'detailed'],
+                        description: 'Generation style',
+                        default: 'default',
+                    },
+                },
+                required: ['description'],
+            },
+        },
+        {
+            name: 'visualize_ir',
+            description: 'Generate ASCII visualization of Graph-IR',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ir: {
+                        type: 'string',
+                        description: 'Graph-IR JSON string to visualize',
+                    },
+                    style: {
+                        type: 'string',
+                        enum: ['box', 'compact', 'tree'],
+                        description: 'Visualization style',
+                        default: 'box',
+                    },
+                },
+                required: ['ir'],
+            },
+        },
+        {
+            name: 'layout_ir',
+            description: 'Compute graph layout using ELK algorithm',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ir: {
+                        type: 'string',
+                        description: 'Graph-IR JSON string to layout',
+                    },
+                    algorithm: {
+                        type: 'string',
+                        enum: ['layered', 'force', 'mrtree', 'box', 'stress'],
+                        description: 'ELK algorithm to use',
+                        default: 'layered',
+                    },
+                    options: {
+                        type: 'object',
+                        description: 'Additional ELK layout options',
+                    },
+                },
+                required: ['ir'],
+            },
+        },
+        {
+            name: 'list_symbols',
+            description: 'List available symbols with optional filtering',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    notation: {
+                        type: 'string',
+                        description: 'Filter by notation ID',
+                    },
+                    tag: {
+                        type: 'string',
+                        description: 'Filter by tag',
+                    },
+                    query: {
+                        type: 'string',
+                        description: 'Search query (matches name/description)',
+                    },
+                    full: {
+                        type: 'boolean',
+                        description: 'Include full definitions (default: false, returns IDs only)',
+                        default: false,
+                    },
+                },
+            },
+        },
+        {
+            name: 'list_notations',
+            description: 'List available notations',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    full: {
+                        type: 'boolean',
+                        description: 'Include full definitions (default: false, returns IDs only)',
+                        default: false,
+                    },
+                },
+            },
+        },
+        {
+            name: 'validate_notation',
+            description: 'Validate Graph-IR against notation rules (symbol validity, connection rules)',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    ir: {
+                        type: 'string',
+                        description: 'Graph-IR JSON string to validate',
+                    },
+                    notation: {
+                        type: 'string',
+                        description: 'Notation to validate against (overrides metadata.notation)',
+                    },
+                    strict: {
+                        type: 'boolean',
+                        description: 'Treat warnings as errors',
+                        default: false,
+                    },
+                },
+                required: ['ir'],
+            },
+        },
+    ],
+}));
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'validate_ir': {
+                const result = await validateIR(args?.ir, args?.strict);
+                return formatResult(result);
+            }
+            case 'generate_ir': {
+                const result = await generateIR(args?.description, args?.style);
+                return formatResult(result);
+            }
+            case 'visualize_ir': {
+                const result = await visualizeIR(args?.ir, args?.style);
+                return formatResult(result);
+            }
+            case 'layout_ir': {
+                const result = await layoutIR(args?.ir, args?.algorithm, args?.options);
+                return formatResult(result);
+            }
+            case 'list_symbols': {
+                const result = await listSymbols({
+                    notation: args?.notation,
+                    tag: args?.tag,
+                    query: args?.query,
+                    full: args?.full,
+                });
+                return formatResult(result);
+            }
+            case 'list_notations': {
+                const result = await listNotations({
+                    full: args?.full,
+                });
+                return formatResult(result);
+            }
+            case 'validate_notation': {
+                const result = await validateNotation({
+                    ir: args?.ir,
+                    notation: args?.notation,
+                    strict: args?.strict,
+                });
+                return formatResult(result);
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Unknown tool: ${name}`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+function formatResult(result) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+        isError: 'errors' in result && Array.isArray(result.errors) && result.errors.length > 0,
+    };
+}
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Graph-IR Tools 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/generate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Graph-IR Generation Tool
+ *
+ * Generates Graph-IR from natural language descriptions.
+ * Note: Full NL processing would require an LLM - this provides
+ * pattern-based generation for common cases.
+ */
+export interface GenerationResult {
+    success: boolean;
+    ir?: GraphIR;
+    errors: string[];
+    notes: string[];
+}
+interface GraphIR {
+    version: string;
+    nodes: Array<{
+        id: string;
+        type: string;
+        label: string;
+    }>;
+    edges: Array<{
+        id: string;
+        source: string;
+        target: string;
+        label?: string;
+    }>;
+}
+/**
+ * Generate Graph-IR from description
+ */
+export declare function generateIR(description: string, style?: string): Promise<GenerationResult>;
+export {};
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/tools/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAoBD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,MAAkB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAsE3B"}

package/dist/tools/generate.js

@@ -0,0 +1,160 @@
+/**
+ * Graph-IR Generation Tool
+ *
+ * Generates Graph-IR from natural language descriptions.
+ * Note: Full NL processing would require an LLM - this provides
+ * pattern-based generation for common cases.
+ */
+// Entity type mapping from keywords
+const TYPE_KEYWORDS = {
+    service: ['service', 'microservice', 'api', 'server', 'backend', 'frontend'],
+    database: ['database', 'db', 'store', 'storage', 'cache', 'redis', 'postgres', 'mysql', 'mongodb'],
+    actor: ['user', 'customer', 'client', 'admin', 'actor', 'person'],
+    external_api: ['external', 'third-party', '3rd party', 'gateway', 'payment'],
+    module: ['module', 'component', 'package', 'library', 'lib'],
+    group: ['group', 'cluster', 'boundary', 'container'],
+};
+// Relationship keywords
+const RELATIONSHIP_KEYWORDS = {
+    http: ['calls', 'requests', 'invokes', 'fetches'],
+    database: ['reads', 'queries', 'writes', 'stores', 'persists'],
+    event: ['sends', 'publishes', 'emits', 'subscribes'],
+    contains: ['contains', 'includes', 'has'],
+};
+/**
+ * Generate Graph-IR from description
+ */
+export async function generateIR(description, style = 'default') {
+    const errors = [];
+    const notes = [];
+    if (!description || description.trim().length === 0) {
+        return {
+            success: false,
+            errors: ['Description is required'],
+            notes: [],
+        };
+    }
+    const lowerDesc = description.toLowerCase();
+    // Extract entities
+    const entities = extractEntities(lowerDesc);
+    if (entities.length === 0) {
+        notes.push('No specific entities detected - using generic nodes');
+        // Create generic nodes from the description
+        const words = description.split(/[\s,]+/).filter(w => w.length > 2);
+        const genericNodes = words.slice(0, 3).map(word => ({
+            name: word,
+            type: 'module',
+        }));
+        entities.push(...genericNodes);
+    }
+    // Extract relationships
+    const relationships = extractRelationships(lowerDesc, entities);
+    // Build Graph-IR
+    const nodes = entities.map((entity, index) => ({
+        id: toId(entity.name),
+        type: entity.type,
+        label: toLabel(entity.name),
+    }));
+    const edges = relationships.map((rel, index) => ({
+        id: `e${index + 1}`,
+        source: rel.source,
+        target: rel.target,
+        label: rel.label,
+    }));
+    // Add implicit edges if none found
+    if (edges.length === 0 && nodes.length > 1) {
+        notes.push('No explicit relationships found - adding sequential connections');
+        for (let i = 0; i < nodes.length - 1; i++) {
+            edges.push({
+                id: `e${i + 1}`,
+                source: nodes[i].id,
+                target: nodes[i + 1].id,
+                label: undefined,
+            });
+        }
+    }
+    const ir = {
+        version: '1.0.0',
+        nodes,
+        edges,
+    };
+    return {
+        success: true,
+        ir,
+        errors,
+        notes,
+    };
+}
+function extractEntities(text) {
+    const entities = [];
+    const foundNames = new Set();
+    // Look for type keywords followed by potential names
+    for (const [type, keywords] of Object.entries(TYPE_KEYWORDS)) {
+        for (const keyword of keywords) {
+            // Pattern: "keyword name" or "name keyword"
+            const patterns = [
+                new RegExp(`${keyword}\\s+([a-z][a-z0-9_-]*)`, 'gi'),
+                new RegExp(`([a-z][a-z0-9_-]*)\\s+${keyword}`, 'gi'),
+            ];
+            for (const pattern of patterns) {
+                let match;
+                while ((match = pattern.exec(text)) !== null) {
+                    const name = match[1].toLowerCase();
+                    if (!foundNames.has(name) && name.length > 1 && !isStopWord(name)) {
+                        foundNames.add(name);
+                        entities.push({ name, type });
+                    }
+                }
+            }
+        }
+    }
+    // Also look for quoted strings as names
+    const quotedPattern = /"([^"]+)"/g;
+    let match;
+    while ((match = quotedPattern.exec(text)) !== null) {
+        const name = match[1].toLowerCase();
+        if (!foundNames.has(name)) {
+            foundNames.add(name);
+            entities.push({ name, type: 'module' });
+        }
+    }
+    return entities;
+}
+function extractRelationships(text, entities) {
+    const relationships = [];
+    const entityIds = entities.map(e => toId(e.name));
+    // Look for relationship patterns
+    for (const [label, keywords] of Object.entries(RELATIONSHIP_KEYWORDS)) {
+        for (const keyword of keywords) {
+            // Pattern: "A calls B" or "A -> B"
+            const pattern = new RegExp(`([a-z][a-z0-9_-]*)\\s+(?:${keyword}|->|→)\\s+([a-z][a-z0-9_-]*)`, 'gi');
+            let match;
+            while ((match = pattern.exec(text)) !== null) {
+                const source = toId(match[1]);
+                const target = toId(match[2]);
+                // Only add if both ends are known entities
+                if (entityIds.includes(source) && entityIds.includes(target)) {
+                    relationships.push({ source, target, label });
+                }
+            }
+        }
+    }
+    return relationships;
+}
+function toId(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function toLabel(name) {
+    return name
+        .split(/[-_\s]+/)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+function isStopWord(word) {
+    const stopWords = ['the', 'a', 'an', 'and', 'or', 'with', 'to', 'from', 'for', 'in', 'on'];
+    return stopWords.includes(word.toLowerCase());
+}
+//# sourceMappingURL=generate.js.map

package/dist/tools/generate.js.map

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