mcp-react-toolkit 1.2.0 → 1.3.1

package/README.md

@@ -2,6 +2,7 @@
 
 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)
@@ -9,6 +10,37 @@ MCP servers for React + TypeScript development automation. Works with Claude Des
 
 ---
 
+## 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
 
 ```
@@ -19,6 +51,18 @@ client/     React 19 showcase SPA — tool catalog, workflow demos, animated flo
 
 ---
 
+## Companion package
+
+[`code-graph-indexer`](https://www.npmjs.com/package/code-graph-indexer) — a standalone code-intelligence engine that indexes any TS / React / Next.js repo into a queryable **code graph** (files · components · functions, and the `imports`/`renders`/`calls`/`references`/`depends-on` edges between them) and answers structural questions — *who renders this, who calls this, find references, blast radius, cycles, dead code* — plus **semantic search** by meaning. Use it over a CLI, an MCP server, an HTTP/WS server, and a 3D web explorer. Separate package, same family:
+
+```bash
+npx code-graph-indexer mcp                       # stdio MCP server (13 tools)
+npx code-graph-indexer index --root .            # one-shot index → .code-graph/graph.json
+npx code-graph-indexer query who-renders --id "cmp:src/Button.tsx#Button" --root .
+```
+
+---
+
 ## Tools
 
 All 17 tools are production-ready: built, tested, and CI-verified on Node 20 + 22.
@@ -131,7 +175,9 @@ 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
@@ -142,7 +188,7 @@ 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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC"}

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

@@ -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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,36 @@
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, SchemaProperty>;
+        required?: string[];
+    };
+}
+export interface SchemaProperty {
+    type: string;
+    description?: string;
+    default?: unknown;
+    enum?: string[];
+    items?: SchemaProperty;
+    properties?: Record<string, SchemaProperty>;
+}
+export interface ToolResult {
+    content: ToolContent[];
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface ToolContent {
+    type: 'text' | 'image' | 'resource';
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+export interface ServerConfig {
+    name: string;
+    version: string;
+    capabilities?: Record<string, unknown>;
+}
+export type ToolHandler = (args: unknown) => Promise<ToolResult>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+// ============================================================================
+// MCP TYPES - Common types for all MCP tools
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6CAA6C;AAC7C,+EAA+E"}

package/node_modules/@mcp-showcase/shared/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@mcp-showcase/shared",
+  "version": "1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/node_modules/@mcp-showcase/shared/src/McpServerBase.ts

@@ -0,0 +1,100 @@
+// ============================================================================
+// 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';
+import type { ServerConfig, ToolDefinition, ToolHandler, ToolResult } from './types.js';
+
+export abstract class McpServerBase {
+  protected server: Server;
+  protected registry: ToolRegistry;
+  protected config: ServerConfig;
+
+  constructor(config: ServerConfig) {
+    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();
+  }
+
+  protected abstract registerTools(): void;
+
+  protected addTool(
+    name: string,
+    description: string,
+    inputSchema: ToolDefinition['inputSchema'],
+    handler: ToolHandler
+  ): void {
+    this.registry.register(name, description, inputSchema, handler);
+  }
+
+  private setupHandlers(): void {
+    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}`);
+      }
+    });
+  }
+
+  private setupErrorHandlers(): void {
+    this.server.onerror = (error) => {
+      console.error(`[${this.config.name}] MCP Error:`, error);
+    };
+    process.on('SIGINT', async () => {
+      await this.shutdown();
+    });
+  }
+
+  protected success<T extends Record<string, unknown>>(data: T): ToolResult {
+    return {
+      content: [{ type: 'text', text: JSON.stringify({ success: true, ...data }, null, 2) }],
+    };
+  }
+
+  protected error(error: unknown): ToolResult {
+    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(): Promise<void> {
+    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(): Promise<void> {
+    await this.server.close();
+    process.exit(0);
+  }
+}

package/node_modules/@mcp-showcase/shared/src/ToolRegistry.ts

@@ -0,0 +1,38 @@
+// ============================================================================
+// TOOL REGISTRY - Tool registration and lookup helper
+// ============================================================================
+
+import type { ToolDefinition, ToolHandler } from './types.js';
+
+interface RegisteredTool {
+  definition: ToolDefinition;
+  handler: ToolHandler;
+}
+
+export class ToolRegistry {
+  private tools: Map<string, RegisteredTool> = new Map();
+
+  register(
+    name: string,
+    description: string,
+    inputSchema: ToolDefinition['inputSchema'],
+    handler: ToolHandler
+  ): void {
+    if (this.tools.has(name)) {
+      throw new Error(`Tool already registered: ${name}`);
+    }
+    this.tools.set(name, { definition: { name, description, inputSchema }, handler });
+  }
+
+  getHandler(name: string): ToolHandler | undefined {
+    return this.tools.get(name)?.handler;
+  }
+
+  getAllDefinitions(): ToolDefinition[] {
+    return Array.from(this.tools.values()).map(t => t.definition);
+  }
+
+  has(name: string): boolean {
+    return this.tools.has(name);
+  }
+}

package/node_modules/@mcp-showcase/shared/src/fs.ts

@@ -0,0 +1,49 @@
+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<T>(filePath: string): T | null {
+  try {
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    return JSON.parse(raw) as T;
+  } catch {
+    return null;
+  }
+}
+
+export function safeReadFile(filePath: string): string | null {
+  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: string): boolean {
+  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: string, content: string): boolean {
+  const name = path.basename(filePath);
+  if (!NEXTJS_ROUTE_FILES.has(name)) return false;
+  return !content.includes("'use client'") && !content.includes('"use client"');
+}

package/node_modules/@mcp-showcase/shared/src/index.ts

@@ -0,0 +1,12 @@
+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';