@kernlang/mcp-server 3.1.6 → 3.1.8

package/README.md

@@ -0,0 +1,324 @@
+# @kernlang/mcp-server
+
+MCP server for KERN -- the LLM-native language that compiles to 12 targets. Give any AI agent the ability to write, compile, review, and self-correct `.kern` code.
+
+```
+npx @kernlang/mcp-server
+```
+
+## What is this?
+
+KERN is a declarative DSL designed specifically for AI code generation. This MCP server exposes KERN's full compiler, reviewer, and schema to any MCP-compatible client (Claude Desktop, Cursor, Windsurf, VS Code, etc.).
+
+An AI agent using this server can:
+1. **Ask what it can write** -- `schema` tool returns the full language spec as JSON
+2. **Compile .kern to any target** -- Next.js, React, Vue, Express, FastAPI, MCP servers, and more
+3. **Self-correct from errors** -- `compile-json` returns structured diagnostics with line numbers and suggestions
+4. **Review code** -- 76+ static analysis rules with taint tracking and OWASP coverage
+
+## Quick start
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "kern": {
+      "command": "npx",
+      "args": ["@kernlang/mcp-server"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "kern": {
+      "command": "npx",
+      "args": ["@kernlang/mcp-server"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add kern -- npx @kernlang/mcp-server
+```
+
+### Windsurf / VS Code
+
+Add to your MCP settings:
+
+```json
+{
+  "kern": {
+    "command": "npx",
+    "args": ["@kernlang/mcp-server"]
+  }
+}
+```
+
+## Tools
+
+### compile
+
+Compile `.kern` source to any target framework. Returns generated code.
+
+```
+source: ".kern source code"
+target: "nextjs" | "react" | "vue" | "express" | "fastapi" | "mcp" | ...
+```
+
+### compile-json
+
+Compile with structured JSON diagnostics for programmatic self-correction. Returns `{ success, code, diagnostics, stats }`.
+
+Each diagnostic includes `code`, `severity`, `line`, `col`, `endCol`, and `suggestion` -- everything an LLM needs to fix its own mistakes.
+
+### schema
+
+Returns the full KERN language schema as JSON: all node types, their props (with required/optional and types), allowed children, style shorthands, and multiline block types.
+
+Use this before writing `.kern` code to know exactly what's valid.
+
+### review
+
+Run static analysis (76+ rules, taint tracking, OWASP) on TypeScript/JavaScript source code.
+
+### review-kern
+
+Lint `.kern` source for structural issues, missing props, and pattern violations.
+
+### review-mcp-server
+
+Scan MCP server code for security vulnerabilities. 13 rules mapped to OWASP MCP Top 10.
+
+### parse
+
+Parse `.kern` source and return the intermediate representation (IR). Useful for debugging.
+
+### decompile
+
+Convert parsed IR back to human-readable `.kern` text.
+
+### validate
+
+Validate `.kern` syntax without compiling. Returns parse errors or success.
+
+### list-targets
+
+List all 12 available compile targets with descriptions.
+
+### list-nodes
+
+Browse KERN node types by category (layout, backend, state, types, mcp, etc.) with their props and allowed children.
+
+## Resources
+
+| Resource | URI | Description |
+|----------|-----|-------------|
+| kern-spec | `kern://spec` | Full language specification |
+| kern-examples | `kern://examples/{category}` | Example code by category (ui, api, state-machine, mcp, terminal) |
+| kern-targets | `kern://targets` | Available compile targets as JSON |
+
+## Prompts
+
+### write-kern
+
+Comprehensive system prompt that teaches an LLM how to write `.kern` code -- grammar rules, node types, style shorthands, and annotated examples for UI, API, state machines, MCP servers, hooks, and type systems.
+
+## LLM self-correction loop
+
+The `schema` and `compile-json` tools enable a closed-loop workflow:
+
+```
+1. schema          --> "what can I write?"
+2. write .kern     --> generate code using schema
+3. compile-json    --> "did I get it right?"
+4. if errors:
+     read diagnostics (line, col, suggestion)
+     fix and goto 3
+5. done
+```
+
+No human intervention needed. The LLM can iterate to correct code autonomously.
+
+## KERN syntax at a glance
+
+```kern
+// Comments work with // or #
+
+doc text="User management API"
+server name=UserAPI port=3001
+  middleware name=cors
+  middleware name=json
+
+  route GET /api/users
+    auth required
+    handler <<<
+      const users = await db.query('SELECT * FROM users');
+      res.json(users);
+    >>>
+```
+
+```kern
+// State machine -- 7 lines, 140+ lines TypeScript output
+machine name=Order initial=pending
+  transition from=pending to=confirmed event=confirm
+  transition from=confirmed to=shipped event=ship
+  transition from=shipped to=delivered event=deliver
+  transition from=pending to=cancelled event=cancel
+```
+
+## Project structure
+
+A typical KERN project looks like this:
+
+```
+my-project/
+  kern.config.ts          # KERN configuration
+  src/
+    features/
+      auth.kern           # .kern source files
+      dashboard.kern
+  generated/              # compiled output (--outdir)
+    auth.ts
+    dashboard.tsx
+  src/                    # facade re-exports (--facades)
+    auth.ts               # export * from '../generated/auth.js'
+    dashboard.ts
+  index.ts                # barrel exports (auto-generated)
+```
+
+With `kern compile src/features --outdir=generated --facades`, you write `.kern` files and everything else is auto-generated.
+
+## Configuration
+
+Create `kern.config.ts` in your project root:
+
+```ts
+import type { KernConfig } from 'kern-lang';
+
+const config: KernConfig = {
+  // Target framework
+  target: 'nextjs',
+
+  // Output directory for generated files
+  output: {
+    outDir: 'src/generated',
+    sourceMaps: true,
+  },
+
+  // i18n support
+  i18n: {
+    enabled: true,
+    hookName: 'useTranslation',
+    importPath: 'react-i18next',
+  },
+
+  // Component import mappings
+  components: {
+    uiLibrary: '@components/ui',
+    componentRoot: '@/components',
+  },
+
+  // Color palette (hex -> Tailwind class)
+  colors: {
+    '#09090b': 'zinc-950',
+    '#f97316': 'orange-500',
+  },
+
+  // Code review settings
+  review: {
+    showConfidence: true,
+    maxComplexity: 15,
+  },
+};
+
+export default config;
+```
+
+The config is auto-loaded by the CLI. All fields are optional -- sensible defaults are applied.
+
+### Configuration options
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `target` | `nextjs` | Compile target (auto-detected from package.json) |
+| `structure` | `flat` | Output structure: `flat`, `bulletproof`, `atomic`, `kern` |
+| `output.outDir` | `.` | Directory for generated files |
+| `output.sourceMaps` | `false` | Generate `.map` files |
+| `i18n.enabled` | `true` | Wrap strings in `t()` calls |
+| `i18n.hookName` | `useTranslation` | i18n hook name |
+| `components.uiLibrary` | `@components/ui` | UI component import path |
+| `colors` | Zinc scale | Hex-to-Tailwind color mappings |
+| `review.maxComplexity` | `15` | Max cognitive complexity |
+| `review.disabledRules` | `[]` | Rule IDs to disable |
+| `express.security` | `strict` | Express security level |
+| `fastapi.cors` | `false` | Enable CORS for FastAPI |
+
+## CLI commands
+
+The KERN CLI (`kern-lang` npm package) provides these commands:
+
+```bash
+# Compile .kern files to TypeScript
+kern compile src/ --outdir=generated --facades --barrel
+
+# Compile with JSON diagnostics (for LLM self-correction)
+kern compile src/ --outdir=generated --json
+
+# Dump full language schema as JSON
+kern schema
+
+# Watch mode -- recompile on changes
+kern dev src/
+
+# Scan project and auto-detect target
+kern scan
+
+# LLM-powered code review
+kern review src/
+```
+
+### Compile flags
+
+| Flag | Description |
+|------|-------------|
+| `--outdir=DIR` | Output directory (default: `generated/`) |
+| `--target=TARGET` | Override compile target |
+| `--facades` | Auto-generate `src/*.ts` re-export facades |
+| `--facades-dir=DIR` | Custom facades directory |
+| `--barrel` | Generate barrel `index.ts` in output dir |
+| `--strict-parse` | Fail on parse errors |
+| `--json` | Output structured JSON diagnostics |
+
+## Compile targets
+
+| Target | Output |
+|--------|--------|
+| `nextjs` | Next.js App Router (TypeScript/React) |
+| `tailwind` | React + Tailwind CSS |
+| `web` | Plain React components |
+| `vue` | Vue 3 SFC |
+| `nuxt` | Nuxt 3 |
+| `express` | Express TypeScript REST API |
+| `fastapi` | FastAPI Python async backend |
+| `native` | React Native (iOS/Android) |
+| `cli` | Node.js CLI |
+| `terminal` | Terminal UI (ANSI) |
+| `ink` | Ink (React for terminals) |
+| `mcp` | MCP server (Model Context Protocol) |
+
+## License
+
+AGPL-3.0

package/dist/__tests__/server.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/server.integration.test.js

@@ -0,0 +1,150 @@
+import { spawn } from 'child_process';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SERVER_PATH = resolve(__dirname, '../../dist/index.js');
+function sendMCP(messages) {
+    return new Promise((resolve, reject) => {
+        const cp = spawn('node', [SERVER_PATH], { stdio: ['pipe', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        cp.stdout.on('data', (d) => {
+            stdout += d.toString();
+        });
+        cp.stderr.on('data', (d) => {
+            stderr += d.toString();
+        });
+        for (const msg of messages) {
+            cp.stdin.write(`${JSON.stringify(msg)}\n`);
+        }
+        setTimeout(() => {
+            cp.kill();
+            resolve({ stdout, stderr });
+        }, 3000);
+        cp.on('error', reject);
+    });
+}
+function rpc(method, params = {}, id = 1) {
+    return { jsonrpc: '2.0', method, params, id };
+}
+describe('KERN MCP Server Integration', () => {
+    it('should respond to initialize', async () => {
+        const { stdout } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }),
+        ]);
+        const response = JSON.parse(stdout.split('\n')[0]);
+        expect(response.result.serverInfo.name).toBe('kern');
+        expect(response.result.serverInfo.version).toBe('3.0.0');
+        expect(response.result.capabilities.tools).toBeDefined();
+        expect(response.result.capabilities.resources).toBeDefined();
+        expect(response.result.capabilities.prompts).toBeDefined();
+    });
+    it('should list tools', async () => {
+        const { stdout } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }, 1),
+            { jsonrpc: '2.0', method: 'notifications/initialized' },
+            rpc('tools/list', {}, 2),
+        ]);
+        const lines = stdout.split('\n').filter(Boolean);
+        const listResponse = JSON.parse(lines[lines.length - 1]);
+        const toolNames = listResponse.result.tools.map((t) => t.name);
+        expect(toolNames).toContain('compile');
+        expect(toolNames).toContain('review');
+        expect(toolNames).toContain('parse');
+        expect(toolNames).toContain('validate');
+        expect(toolNames).toContain('list-targets');
+    });
+    it('should compile .kern source via tools/call', async () => {
+        const { stdout } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }, 1),
+            { jsonrpc: '2.0', method: 'notifications/initialized' },
+            rpc('tools/call', {
+                name: 'compile',
+                arguments: {
+                    source: 'page name=Home\n  text value="Hello"',
+                    target: 'nextjs',
+                },
+            }, 2),
+        ]);
+        const lines = stdout.split('\n').filter(Boolean);
+        const callResponse = JSON.parse(lines[lines.length - 1]);
+        expect(callResponse.result.content[0].type).toBe('text');
+        expect(callResponse.result.content[0].text).toContain('Compiled to nextjs');
+    });
+    it('should parse .kern source', async () => {
+        const { stdout } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }, 1),
+            { jsonrpc: '2.0', method: 'notifications/initialized' },
+            rpc('tools/call', {
+                name: 'parse',
+                arguments: { source: 'screen name=Dashboard\n  text value="Hello"' },
+            }, 2),
+        ]);
+        const lines = stdout.split('\n').filter(Boolean);
+        const callResponse = JSON.parse(lines[lines.length - 1]);
+        expect(callResponse.result.content[0].text).toContain('IR tokens');
+    });
+    it('should validate .kern source', async () => {
+        const { stdout } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }, 1),
+            { jsonrpc: '2.0', method: 'notifications/initialized' },
+            rpc('tools/call', {
+                name: 'validate',
+                arguments: { source: 'button label="Click"' },
+            }, 2),
+        ]);
+        const lines = stdout.split('\n').filter(Boolean);
+        const callResponse = JSON.parse(lines[lines.length - 1]);
+        expect(callResponse.result.content[0].text).toContain('Valid .kern');
+    });
+    it('should list targets', async () => {
+        const { stdout } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }, 1),
+            { jsonrpc: '2.0', method: 'notifications/initialized' },
+            rpc('tools/call', { name: 'list-targets', arguments: {} }, 2),
+        ]);
+        const lines = stdout.split('\n').filter(Boolean);
+        const callResponse = JSON.parse(lines[lines.length - 1]);
+        const text = callResponse.result.content[0].text;
+        expect(text).toContain('12 targets');
+        expect(text).toContain('mcp');
+        expect(text).toContain('nextjs');
+        expect(text).toContain('express');
+    });
+    it('should log server start to stderr', async () => {
+        const { stderr } = await sendMCP([
+            rpc('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'test', version: '1.0' },
+            }),
+        ]);
+        expect(stderr).toContain('server:start');
+        expect(stderr).toContain('"name":"kern"');
+    });
+});
+//# sourceMappingURL=server.integration.test.js.map

package/dist/__tests__/server.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.integration.test.js","sourceRoot":"","sources":["../../src/__tests__/server.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAE9D,SAAS,OAAO,CAAC,QAAkB;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7E,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACjC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACjC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,UAAU,CAAC,GAAG,EAAE;YACd,EAAE,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9B,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,EAAE,GAAG,CAAC;IACtD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAChD,CAAC;AAED,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CAAC,YAAY,EAAE;gBAChB,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7D,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CACD,YAAY,EACZ;gBACE,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,EACD,CAAC,CACF;YACD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE;YACvD,GAAG,CAAC,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;SACzB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEjF,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CACD,YAAY,EACZ;gBACE,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,EACD,CAAC,CACF;YACD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE;YACvD,GAAG,CACD,YAAY,EACZ;gBACE,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE;oBACT,MAAM,EAAE,sCAAsC;oBAC9C,MAAM,EAAE,QAAQ;iBACjB;aACF,EACD,CAAC,CACF;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CACD,YAAY,EACZ;gBACE,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,EACD,CAAC,CACF;YACD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE;YACvD,GAAG,CACD,YAAY,EACZ;gBACE,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,EAAE,MAAM,EAAE,6CAA6C,EAAE;aACrE,EACD,CAAC,CACF;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CACD,YAAY,EACZ;gBACE,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,EACD,CAAC,CACF;YACD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE;YACvD,GAAG,CACD,YAAY,EACZ;gBACE,IAAI,EAAE,UAAU;gBAChB,SAAS,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE;aAC9C,EACD,CAAC,CACF;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CACD,YAAY,EACZ;gBACE,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,EACD,CAAC,CACF;YACD,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE;YACvD,GAAG,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;SAC9D,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC;YAC/B,GAAG,CAAC,YAAY,EAAE;gBAChB,eAAe,EAAE,YAAY;gBAC7B,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;aAC7C,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -2,13 +2,10 @@
 /**
  * @kernlang/mcp-server — KERN MCP Server
  *
- * Exposes KERN's compile, review, parse, and analysis tools via MCP.
- * AI agents can use these tools to write, compile, and review .kern files.
+ * Complete MCP interface for KERN: compile, review, parse, decompile, and analyze.
+ * AI agents can write .kern, compile to 12 targets, review code, and scan MCP servers.
  *
- * Usage:
- *   kern-mcp                    # stdio transport (default)
- *
- * Claude Desktop config:
- *   { "mcpServers": { "kern": { "command": "kern-mcp" } } }
+ * Usage:  kern-mcp
+ * Config: { "mcpServers": { "kern": { "command": "npx", "args": ["@kernlang/mcp-server"] } } }
  */
 export {};