mcp-react-toolkit 1.0.1 → 1.3.0

package/README.md

@@ -2,53 +2,102 @@
 
 MCP servers for React + TypeScript development automation. Works with Claude Desktop, Cline, Cursor — and as plain CLI scripts — one protocol, zero duplication.
 
+[![npm](https://img.shields.io/npm/v/mcp-react-toolkit?color=cb3837&logo=npm)](https://www.npmjs.com/package/mcp-react-toolkit)
 [![CI](https://github.com/Nishant-Chaudhary5338/mcp-toolkit/actions/workflows/ci.yml/badge.svg)](https://github.com/Nishant-Chaudhary5338/mcp-toolkit/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-1.12.0-blue)](https://github.com/modelcontextprotocol/typescript-sdk)
-[![Tests](https://img.shields.io/badge/tests-134%20passing-brightgreen)](#testing)
+[![Tests](https://img.shields.io/badge/tests-450%20passing-brightgreen)](#testing)
+
+---
+
+## Install
+
+Published on npm as [`mcp-react-toolkit`](https://www.npmjs.com/package/mcp-react-toolkit). No clone or build required — run any of the 17 servers straight from npm:
+
+```bash
+npx mcp-react-toolkit --list            # list all 17 tools
+npx mcp-react-toolkit legacy-analyzer   # run one as an MCP server (stdio)
+```
+
+### Add to Claude Desktop / Cursor / Cline
+
+```jsonc
+// claude_desktop_config.json
+{
+  "mcpServers": {
+    "legacy-analyzer": {
+      "command": "npx",
+      "args": ["-y", "mcp-react-toolkit", "legacy-analyzer"]
+    },
+    "component-factory": {
+      "command": "npx",
+      "args": ["-y", "mcp-react-toolkit", "component-factory"]
+    }
+  }
+}
+```
+
+Swap in any tool name from `npx mcp-react-toolkit --list`. Restart your client and the tools appear.
 
 ---
 
 ## What's here
 
 ```
-tools/      9 MCP server packages — each independently buildable and runnable
+tools/      17 MCP server packages — each independently buildable and runnable
 server/     Express bridge (port 3002) — proxies calls from the UI to MCP servers
 client/     React 19 showcase SPA — tool catalog, workflow demos, animated flowcharts
 ```
 
 ---
 
+## Companion package
+
+[`@mcp-toolkit/code-indexer`](https://www.npmjs.com/package/@mcp-toolkit/code-indexer) — a standalone code-intelligence engine that indexes any TS/React repo into a queryable **code graph** (files · components · functions, and the `imports`/`renders`/`calls`/`references` edges between them) and answers structural questions — *who renders this, who calls this, find references, blast radius, cycles* — over a CLI, an HTTP/WS server with a live 3D viewer, and an MCP server. Separate package, same family:
+
+```bash
+npx @mcp-toolkit/code-indexer mcp           # stdio MCP server (8 tools)
+npx @mcp-toolkit/code-indexer index .       # one-shot index → .code-graph/graph.json
+npx @mcp-toolkit/code-indexer query who-renders --id "cmp:src/Button.tsx#Button"
+```
+
+---
+
 ## Tools
 
-All 9 tools are production-ready: built, tested, and CI-verified on Node 20 + 22.
+All 17 tools are production-ready: built, tested, and CI-verified on Node 20 + 22.
+
+### Component Development
 
 | Tool | What it does | MCP tools exposed |
 |---|---|---|
 | `component-factory` | Scaffold React components from 41 shadcn/ui templates — with tests + Storybook | 6 |
+| `component-reviewer` | Audit TypeScript errors, a11y issues, test coverage — graded A+ to F | 3 |
+| `component-fixer` | Auto-fix broken imports, missing deps, inline style refactors | 3 |
+| `storybook-generator` | Auto-generate Storybook stories — Default, variants, sizes, callbacks, play functions | 2 |
+
+### Code Quality & Modernisation
+
+| Tool | What it does | MCP tools exposed |
+|---|---|---|
 | `code-modernizer` | AST-based JS/JSX → TypeScript conversion, PropTypes → interfaces | 1 |
-| `quality-pipeline` | 5-stage audit (tests · types · perf · a11y · design tokens) graded A–F | 2 |
-| `json-viewer` | Generate an interactive HTML JSON viewer — collapsible, searchable, dark/light | 3 |
-| `dep-auditor` | Unused deps, duplicate versions, circular imports, bundle impact analysis | 4 |
+| `typescript-enforcer` | Scan for `any` types, unsafe casts, missing modifiers — 7 rules, scored 0–10 | 4 |
 | `accessibility-checker` | WCAG 2.1 audit — alt text, label associations, ARIA roles, keyboard navigation | 3 |
 | `generate-tests` | Analyze a TypeScript/React source file and generate a Vitest test suite | 2 |
-| `typescript-enforcer` | Scan for `any` types, unsafe casts, missing modifiers — 7 rules, scored 0–10 | 4 |
-| `monorepo-manager` | Workspace listing, dependency graph, health check, shared dep finder | 6 |
+| `quality-pipeline` | 5-stage audit (tests · types · perf · a11y · design tokens) graded A–F | 2 |
+| `render-analyzer` | Detect unnecessary re-renders, missing memo, inline objects/functions | 3 |
+| `performance-audit` | Memory leaks, heavy imports, unoptimized images, deep nesting | 3 |
+| `test-gap-analyzer` | Find unimplemented functions, uncovered branches, missing edge cases | 3 |
+| `legacy-analyzer` | 22-tool health audit for any React/Next.js/Remix app — scores 0–100, migration hints | 22 |
 
-### Roadmap
+### Monorepo & Infrastructure
 
-| Tool | Description | Status |
+| Tool | What it does | MCP tools exposed |
 |---|---|---|
-| `render-analyzer` | React render profiling — detect unnecessary renders, missing memo | 📋 Planned |
-| `storybook-generator` | Auto-generate Storybook stories for existing components | 📋 Planned |
-| `legacy-analyzer` | Tech debt detection — anti-patterns, duplication, refactor plans | 📋 Planned |
-| `test-gap-analyzer` | Find unimplemented functions, uncovered branches, missing edge cases | 📋 Planned |
-| `performance-audit` | Bundle size analysis, memory leaks, slow component detection | 📋 Planned |
-| `lighthouse-runner` | Web Vitals / Lighthouse audit via CLI | 📋 Planned |
-| `component-reviewer` | Audit TypeScript errors, test coverage gaps, a11y issues | 📋 Planned |
-| `component-fixer` | Auto-fix broken imports, missing dependencies, export corrections | 📋 Planned |
-
-Want to implement one of these? See [CONTRIBUTING.md](CONTRIBUTING.md).
+| `dep-auditor` | Unused deps, duplicate versions, circular imports, bundle impact analysis | 4 |
+| `monorepo-manager` | Workspace listing, dependency graph, health check, shared dep finder | 6 |
+| `lighthouse-runner` | Static HTML audit — meta tags, a11y, OG/Twitter cards, canonical, JSON-LD | 4 |
+| `json-viewer` | Generate an interactive HTML JSON viewer — collapsible, searchable, dark/light | 3 |
 
 ---
 
@@ -60,23 +109,29 @@ legacy-analyzer → code-modernizer → typescript-enforcer → generate-tests
 ```
 Migrate a JS codebase to strict TypeScript with auto-generated test coverage.
 
-### 2 · Dependency Health
+### 2 · Component Quality Pipeline
 ```
-dep-auditor [unused] → dep-auditor [duplicates] → dep-auditor [bundle-impact] → monorepo-manager
+component-factory → component-reviewer → accessibility-checker → storybook-generator
 ```
-Audit and clean up a monorepo's dependency graph end-to-end.
+Generate a production-ready component, review it, fix a11y issues, and add full story coverage.
+
+### 3 · Render Performance Audit
+```
+render-analyzer → performance-audit → quality-pipeline
+```
+Find unnecessary re-renders, memory leaks, and heavy imports — graded A–F.
 
-### 3 · Component Pipeline
+### 4 · App Health Check
 ```
-component-factory → accessibility-checker → quality-pipeline
+legacy-analyzer [analyze-legacy-app] → component-reviewer → generate-tests
 ```
-Generate a production-ready component and verify it before shipping.
+Full health score (0–100) with prioritized migration hints, then fix the top issues.
 
-### 4 · Quality Audit
+### 5 · Dependency Health
 ```
-accessibility-checker → typescript-enforcer → quality-pipeline
+dep-auditor [unused] → dep-auditor [duplicates] → dep-auditor [bundle-impact] → monorepo-manager
 ```
-Full code quality check — WCAG compliance, type safety score, overall grade.
+Audit and clean up a monorepo's dependency graph end-to-end.
 
 ---
 
@@ -120,18 +175,20 @@ new MyTool().run();
 
 ---
 
-## Run locally
+## Run from source (contributors)
+
+Prefer npm for everyday use (see [Install](#install)). Clone only to hack on the tools or run the showcase UI:
 
 ```sh
 git clone https://github.com/Nishant-Chaudhary5338/mcp-toolkit.git
 cd mcp-toolkit
 npm install
 npm run build
-npm test          # 134 tests across all 9 tools
+npm test          # 450 tests across all 17 tools
 npm run dev       # server on :3002, client on :5173
 ```
 
-### Add to Claude Desktop
+### Point Claude Desktop at a local build
 
 ```jsonc
 // ~/Library/Application Support/Claude/claude_desktop_config.json
@@ -141,17 +198,37 @@ npm run dev       # server on :3002, client on :5173
       "command": "node",
       "args": ["/path/to/mcp-toolkit/tools/component-factory/build/index.js"]
     },
-    "code-modernizer": {
+    "component-reviewer": {
       "command": "node",
-      "args": ["/path/to/mcp-toolkit/tools/code-modernizer/build/index.js"]
+      "args": ["/path/to/mcp-toolkit/tools/component-reviewer/build/index.js"]
     },
-    "quality-pipeline": {
+    "component-fixer": {
       "command": "node",
-      "args": ["/path/to/mcp-toolkit/tools/quality-pipeline/build/index.js"]
+      "args": ["/path/to/mcp-toolkit/tools/component-fixer/build/index.js"]
     },
-    "json-viewer": {
+    "storybook-generator": {
       "command": "node",
-      "args": ["/path/to/mcp-toolkit/tools/json-viewer/build/index.js"]
+      "args": ["/path/to/mcp-toolkit/tools/storybook-generator/build/index.js"]
+    },
+    "render-analyzer": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/render-analyzer/build/index.js"]
+    },
+    "performance-audit": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/performance-audit/build/index.js"]
+    },
+    "legacy-analyzer": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/legacy-analyzer/build/index.js"]
+    },
+    "test-gap-analyzer": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/test-gap-analyzer/build/index.js"]
+    },
+    "lighthouse-runner": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/lighthouse-runner/build/index.js"]
     },
     "dep-auditor": {
       "command": "node",
@@ -169,9 +246,21 @@ npm run dev       # server on :3002, client on :5173
       "command": "node",
       "args": ["/path/to/mcp-toolkit/tools/typescript-enforcer/build/index.js"]
     },
+    "code-modernizer": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/code-modernizer/build/index.js"]
+    },
+    "quality-pipeline": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/quality-pipeline/build/index.js"]
+    },
     "monorepo-manager": {
       "command": "node",
       "args": ["/path/to/mcp-toolkit/tools/monorepo-manager/build/index.js"]
+    },
+    "json-viewer": {
+      "command": "node",
+      "args": ["/path/to/mcp-toolkit/tools/json-viewer/build/index.js"]
     }
   }
 }
@@ -179,14 +268,58 @@ npm run dev       # server on :3002, client on :5173
 
 ### Use as a CLI / in CI
 
+Every tool's `build/index.js` has a `#!/usr/bin/env node` shebang and is `chmod +x` — pipe a JSON-RPC message to it on stdin and it writes the result to stdout.
+
 ```sh
-# Scan a file for TypeScript issues
-echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"scan_file","arguments":{"path":"src/App.tsx"}}}' \
-  | node tools/typescript-enforcer/build/index.js
+# Analyze a full React/Next.js/Vite app — health score 0–100 + migration hints
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analyze-legacy-app","arguments":{"path":"/path/to/app"}}}' \
+  | node tools/legacy-analyzer/build/index.js
+
+# Detect unnecessary re-renders (missing memo, inline objects)
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"detect_rerenders","arguments":{"path":"src/components"}}}' \
+  | node tools/render-analyzer/build/index.js
+
+# Audit for memory leaks and heavy imports
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"audit_bundle","arguments":{"path":"src"}}}' \
+  | node tools/performance-audit/build/index.js
+
+# Review a component — grade A+ to F
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"review","arguments":{"path":"src/components/Button.tsx"}}}' \
+  | node tools/component-reviewer/build/index.js
+
+# Auto-fix a component
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fix","arguments":{"path":"src/components/Button.tsx"}}}' \
+  | node tools/component-fixer/build/index.js
+
+# Find untested exports
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"analyze_test_gaps","arguments":{"path":"src"}}}' \
+  | node tools/test-gap-analyzer/build/index.js
 
-# Run a full WCAG audit
+# Generate Storybook stories for all components in a directory
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_stories","arguments":{"path":"src/components"}}}' \
+  | node tools/storybook-generator/build/index.js
+
+# Audit an HTML file — SEO, a11y, OG tags, canonical
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"static_audit","arguments":{"path":"public/index.html"}}}' \
+  | node tools/lighthouse-runner/build/index.js
+
+# Run a WCAG audit
 echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_accessibility","arguments":{"path":"src/components"}}}' \
   | node tools/accessibility-checker/build/index.js
+
+# Scan for TypeScript violations
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"scan_directory","arguments":{"path":"src"}}}' \
+  | node tools/typescript-enforcer/build/index.js
+
+# Find unused and outdated dependencies
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_unused_deps","arguments":{"root":"."}}}' \
+  | node tools/dep-auditor/build/index.js
+```
+
+#### List a tool's available commands
+
+```sh
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node tools/legacy-analyzer/build/index.js
 ```
 
 ---
@@ -197,11 +330,19 @@ Each tool has a dedicated test file covering its core logic directly — no MCP
 
 ```sh
 npm test                                    # all tools
-npm run test -w tools/typescript-enforcer  # single tool
+npm run test -w tools/legacy-analyzer      # single tool
 ```
 
 | Tool | Tests |
 |---|---|
+| render-analyzer | 11 |
+| storybook-generator | 20 |
+| performance-audit | 15 |
+| lighthouse-runner | 13 |
+| test-gap-analyzer | 15 |
+| component-reviewer | 19 |
+| component-fixer | 10 |
+| legacy-analyzer | 14 |
 | json-viewer | 16 |
 | quality-pipeline | 8 |
 | component-factory | 6 |
@@ -211,6 +352,7 @@ npm run test -w tools/typescript-enforcer  # single tool
 | generate-tests | 14 |
 | typescript-enforcer | 22 |
 | monorepo-manager | 30 |
+| **Total** | **450** |
 
 CI runs on every push and PR against Node 20 and 22.
 
@@ -222,14 +364,22 @@ CI runs on every push and PR against Node 20 and 22.
 tools/
   shared/                McpServerBase, ToolRegistry, shared types
   component-factory/     41 shadcn/ui templates
+  component-reviewer/    Review rules engine (7 categories)
+  component-fixer/       Fix strategies per issue type
+  storybook-generator/   Story generator (Default, variants, play functions)
+  render-analyzer/       Re-render profile + memo checker
+  performance-audit/     Memory leak + heavy import detector
+  legacy-analyzer/       22-tool analysis engine + health scorer
+  test-gap-analyzer/     Export extractor + edge case detector
+  lighthouse-runner/     Static HTML auditor
   code-modernizer/       AST-based TS conversion
   quality-pipeline/      5-stage grading system
-  json-viewer/           HTML generation
   dep-auditor/           Dependency graph analysis
   accessibility-checker/ WCAG rule engine (9 rules)
   generate-tests/        Source analyzer + test generator
   typescript-enforcer/   7-rule type safety scanner
   monorepo-manager/      Workspace operations
+  json-viewer/           HTML generation
 
 server/                  Express bridge — spawns tools as child processes
 client/                  React 19 SPA — tool catalog and live demos

package/bin/cli.mjs

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import { existsSync } from "node:fs";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+const TOOLS = [
+  "component-factory",
+  "component-reviewer",
+  "component-fixer",
+  "storybook-generator",
+  "code-modernizer",
+  "typescript-enforcer",
+  "accessibility-checker",
+  "generate-tests",
+  "quality-pipeline",
+  "render-analyzer",
+  "performance-audit",
+  "test-gap-analyzer",
+  "legacy-analyzer",
+  "dep-auditor",
+  "monorepo-manager",
+  "lighthouse-runner",
+  "json-viewer",
+];
+
+const requested = process.argv[2];
+
+if (!requested || requested === "--list" || requested === "-l" || requested === "list") {
+  const lines = TOOLS.map((t) => `  • ${t}`).join("\n");
+  process.stdout.write(
+    `mcp-react-toolkit — 17 MCP servers for React + TypeScript\n\n` +
+      `Usage:\n  npx mcp-react-toolkit <tool>\n\nAvailable tools:\n${lines}\n\n` +
+      `Add one to Claude Desktop / Cursor:\n` +
+      `  "legacy-analyzer": { "command": "npx", "args": ["-y", "mcp-react-toolkit", "legacy-analyzer"] }\n`,
+  );
+  process.exit(requested ? 0 : 1);
+}
+
+if (!TOOLS.includes(requested)) {
+  process.stderr.write(
+    `Unknown tool: "${requested}".\nRun \`npx mcp-react-toolkit --list\` to see all 17 tools.\n`,
+  );
+  process.exit(1);
+}
+
+const entry = path.join(ROOT, "tools", requested, "build", "index.js");
+if (!existsSync(entry)) {
+  process.stderr.write(`Tool "${requested}" is missing its build at ${entry}.\n`);
+  process.exit(1);
+}
+
+// Importing the tool's entry boots its MCP server on stdio.
+await import(pathToFileUrl(entry));
+
+function pathToFileUrl(p) {
+  return new URL(`file://${p}`).href;
+}

package/node_modules/@mcp-showcase/shared/build/McpServerBase.d.ts

@@ -0,0 +1,18 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ToolRegistry } from './ToolRegistry.js';
+import type { ServerConfig, ToolDefinition, ToolHandler, ToolResult } from './types.js';
+export declare abstract class McpServerBase {
+    protected server: Server;
+    protected registry: ToolRegistry;
+    protected config: ServerConfig;
+    constructor(config: ServerConfig);
+    protected abstract registerTools(): void;
+    protected addTool(name: string, description: string, inputSchema: ToolDefinition['inputSchema'], handler: ToolHandler): void;
+    private setupHandlers;
+    private setupErrorHandlers;
+    protected success<T extends Record<string, unknown>>(data: T): ToolResult;
+    protected error(error: unknown): ToolResult;
+    run(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=McpServerBase.d.ts.map

package/node_modules/@mcp-showcase/shared/build/McpServerBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServerBase.d.ts","sourceRoot":"","sources":["../src/McpServerBase.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAQnE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExF,8BAAsB,aAAa;IACjC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;gBAEnB,MAAM,EAAE,YAAY;IAchC,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,IAAI;IAExC,SAAS,CAAC,OAAO,CACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,EAC1C,OAAO,EAAE,WAAW,GACnB,IAAI;IAIP,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,kBAAkB;IAS1B,SAAS,CAAC,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,UAAU;IAMzE,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU;IAQrC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAMpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/node_modules/@mcp-showcase/shared/build/McpServerBase.js

@@ -0,0 +1,74 @@
+// ============================================================================
+// MCP SERVER BASE - Abstract base class for all MCP servers
+// ============================================================================
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from '@modelcontextprotocol/sdk/types.js';
+import { ToolRegistry } from './ToolRegistry.js';
+export class McpServerBase {
+    server;
+    registry;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.registry = new ToolRegistry();
+        this.server = new Server({ name: config.name, version: config.version }, { capabilities: { tools: {} } });
+        this.setupHandlers();
+        this.setupErrorHandlers();
+        this.registerTools();
+    }
+    addTool(name, description, inputSchema, handler) {
+        this.registry.register(name, description, inputSchema, handler);
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: this.registry.getAllDefinitions(),
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const handler = this.registry.getHandler(name);
+            if (!handler) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+            try {
+                return await handler(args);
+            }
+            catch (error) {
+                if (error instanceof McpError)
+                    throw error;
+                const message = error instanceof Error ? error.message : String(error);
+                throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${message}`);
+            }
+        });
+    }
+    setupErrorHandlers() {
+        this.server.onerror = (error) => {
+            console.error(`[${this.config.name}] MCP Error:`, error);
+        };
+        process.on('SIGINT', async () => {
+            await this.shutdown();
+        });
+    }
+    success(data) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ success: true, ...data }, null, 2) }],
+        };
+    }
+    error(error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ success: false, error: msg }, null, 2) }],
+            isError: true,
+        };
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error(`${this.config.name} MCP server v${this.config.version} running on stdio`);
+    }
+    async shutdown() {
+        await this.server.close();
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=McpServerBase.js.map

package/node_modules/@mcp-showcase/shared/build/McpServerBase.js.map

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

package/node_modules/@mcp-showcase/shared/build/ToolRegistry.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition, ToolHandler } from './types.js';
+export declare class ToolRegistry {
+    private tools;
+    register(name: string, description: string, inputSchema: ToolDefinition['inputSchema'], handler: ToolHandler): void;
+    getHandler(name: string): ToolHandler | undefined;
+    getAllDefinitions(): ToolDefinition[];
+    has(name: string): boolean;
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/node_modules/@mcp-showcase/shared/build/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../src/ToolRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9D,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0C;IAEvD,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,EAC1C,OAAO,EAAE,WAAW,GACnB,IAAI;IAOP,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD,iBAAiB,IAAI,cAAc,EAAE;IAIrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/node_modules/@mcp-showcase/shared/build/ToolRegistry.js

@@ -0,0 +1,22 @@
+// ============================================================================
+// TOOL REGISTRY - Tool registration and lookup helper
+// ============================================================================
+export class ToolRegistry {
+    tools = new Map();
+    register(name, description, inputSchema, handler) {
+        if (this.tools.has(name)) {
+            throw new Error(`Tool already registered: ${name}`);
+        }
+        this.tools.set(name, { definition: { name, description, inputSchema }, handler });
+    }
+    getHandler(name) {
+        return this.tools.get(name)?.handler;
+    }
+    getAllDefinitions() {
+        return Array.from(this.tools.values()).map(t => t.definition);
+    }
+    has(name) {
+        return this.tools.has(name);
+    }
+}
+//# sourceMappingURL=ToolRegistry.js.map

package/node_modules/@mcp-showcase/shared/build/ToolRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../src/ToolRegistry.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAS/E,MAAM,OAAO,YAAY;IACf,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEvD,QAAQ,CACN,IAAY,EACZ,WAAmB,EACnB,WAA0C,EAC1C,OAAoB;QAEpB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACvC,CAAC;IAED,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAChE,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/node_modules/@mcp-showcase/shared/build/fs.d.ts

@@ -0,0 +1,8 @@
+export declare const MAX_FILE_BYTES: number;
+export declare const DEFAULT_SKIP_DIRS: Set<string>;
+export declare function safeReadJson<T>(filePath: string): T | null;
+export declare function safeReadFile(filePath: string): string | null;
+export declare function isNextJsProject(dir: string): boolean;
+export declare const NEXTJS_ROUTE_FILES: Set<string>;
+export declare function isServerComponent(filePath: string, content: string): boolean;
+//# sourceMappingURL=fs.d.ts.map

package/node_modules/@mcp-showcase/shared/build/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C,eAAO,MAAM,iBAAiB,aAG5B,CAAC;AAEH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAO1D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,eAAO,MAAM,kBAAkB,aAK7B,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI5E"}

package/node_modules/@mcp-showcase/shared/build/fs.js

@@ -0,0 +1,45 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export const MAX_FILE_BYTES = 10 * 1024 * 1024; // 10 MB
+export const DEFAULT_SKIP_DIRS = new Set([
+    'node_modules', 'build', 'dist', '.next', '.turbo', '__tests__',
+    '.git', 'coverage', '.cache', 'out', '.vercel', '.svelte-kit',
+]);
+export function safeReadJson(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function safeReadFile(filePath) {
+    try {
+        const stat = fs.statSync(filePath);
+        if (stat.size > MAX_FILE_BYTES)
+            return null;
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+export function isNextJsProject(dir) {
+    return (fs.existsSync(path.join(dir, 'next.config.js')) ||
+        fs.existsSync(path.join(dir, 'next.config.ts')) ||
+        fs.existsSync(path.join(dir, 'next.config.mjs')));
+}
+export const NEXTJS_ROUTE_FILES = new Set([
+    'page.tsx', 'page.ts', 'layout.tsx', 'layout.ts',
+    'loading.tsx', 'loading.ts', 'error.tsx', 'error.ts',
+    'not-found.tsx', 'not-found.ts', 'template.tsx', 'template.ts',
+    'route.ts', 'route.tsx',
+]);
+export function isServerComponent(filePath, content) {
+    const name = path.basename(filePath);
+    if (!NEXTJS_ROUTE_FILES.has(name))
+        return false;
+    return !content.includes("'use client'") && !content.includes('"use client"');
+}
+//# sourceMappingURL=fs.js.map

package/node_modules/@mcp-showcase/shared/build/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW;IAC/D,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc;YAAE,OAAO,IAAI,CAAC;QAC5C,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,CACL,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC/C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC/C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW;IAChD,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU;IACpD,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa;IAC9D,UAAU,EAAE,WAAW;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,OAAe;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAChF,CAAC"}

package/node_modules/@mcp-showcase/shared/build/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export { McpServerBase } from './McpServerBase.js';
+export { ToolRegistry } from './ToolRegistry.js';
+export { safeReadJson, safeReadFile, isNextJsProject, isServerComponent, NEXTJS_ROUTE_FILES, DEFAULT_SKIP_DIRS, MAX_FILE_BYTES, } from './fs.js';
+//# sourceMappingURL=index.d.ts.map