@cocaxcode/ai-context-inspector 0.1.0

package/dist/index.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+import {
+  generateHtml,
+  runAllScanners
+} from "./chunk-6HBCUZQJ.js";
+
+// src/cli.ts
+import { parseArgs } from "util";
+import { access, mkdir, writeFile } from "fs/promises";
+import { dirname, resolve } from "path";
+function parseCliArgs(argv) {
+  const { values } = parseArgs({
+    args: argv,
+    options: {
+      dir: { type: "string", short: "d" },
+      output: { type: "string", short: "o" },
+      json: { type: "boolean", default: false },
+      "no-introspect": { type: "boolean", default: false },
+      mcp: { type: "boolean", default: false },
+      "include-user": { type: "boolean", default: false },
+      timeout: { type: "string", default: "10000" },
+      help: { type: "boolean", short: "h", default: false }
+    },
+    strict: false,
+    allowPositionals: true
+  });
+  if (values.help) {
+    printHelp();
+    process.exit(0);
+  }
+  return {
+    dir: values.dir ?? process.cwd(),
+    output: values.output ?? "ai-context-report.html",
+    json: values.json ?? false,
+    noIntrospect: values["no-introspect"] ?? false,
+    mcp: values.mcp ?? false,
+    includeUser: values["include-user"] ?? false,
+    timeout: parseInt(values.timeout ?? "10000", 10)
+  };
+}
+function printHelp() {
+  console.error(`
+  ai-context-inspector \u2014 Escanea el ecosistema AI de un proyecto
+
+  Uso:
+    npx @cocaxcode/ai-context-inspector [opciones]
+
+  Opciones:
+    -d, --dir <ruta>       Directorio a escanear (default: cwd)
+    -o, --output <ruta>    Archivo HTML de salida (default: ai-context-report.html)
+    --json                 Output JSON en stdout (no genera HTML)
+    --no-introspect        No conectar a MCP servers
+    --include-user         Incluir configuraci\xF3n del directorio de usuario
+    --timeout <ms>         Timeout de introspecci\xF3n MCP (default: 10000)
+    --mcp                  Arrancar como MCP server
+    -h, --help             Mostrar ayuda
+`);
+}
+async function runCli(options) {
+  const dir = resolve(options.dir);
+  try {
+    await access(dir);
+  } catch {
+    console.error(`Error: El directorio no existe: ${dir}`);
+    process.exit(1);
+  }
+  const config = {
+    dir,
+    includeUser: options.includeUser,
+    introspect: !options.noIntrospect,
+    timeout: options.timeout
+  };
+  console.error(`Escaneando ${dir}...`);
+  const result = await runAllScanners(config);
+  if (options.json) {
+    process.stdout.write(JSON.stringify(result, null, 2));
+    return;
+  }
+  const html = generateHtml(result);
+  const outputPath = resolve(options.output);
+  await mkdir(dirname(outputPath), { recursive: true });
+  await writeFile(outputPath, html, "utf-8");
+  console.error(`
+Escaneo completado en ${result.scanDuration}ms
+  MCP Servers: ${result.mcpServers.length}
+  Tools: ${result.mcpServers.reduce((s, m) => s + (m.introspection?.tools.length ?? 0), 0)}
+  Archivos: ${result.contextFiles.length}
+  Skills: ${result.skills.length}
+  Memorias: ${result.memories.length}
+  Warnings: ${result.warnings.length}
+
+Reporte: ${outputPath}`);
+}
+
+// src/index.ts
+async function main() {
+  const options = parseCliArgs(process.argv.slice(2));
+  if (options.mcp) {
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const { createServer } = await import("./server-6EILEUO5.js");
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("ai-context-inspector MCP server running on stdio");
+  } else {
+    await runCli(options);
+  }
+}
+main().catch((error) => {
+  console.error("Fatal:", error);
+  process.exit(1);
+});

package/dist/server-6EILEUO5.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+import {
+  generateHtml,
+  introspectServers,
+  runAllScanners,
+  scanMcpConfigs
+} from "./chunk-6HBCUZQJ.js";
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/tools/scan.ts
+import { z } from "zod";
+function registerScanTool(server) {
+  server.tool(
+    "scan",
+    "Escanea un proyecto y descubre todo su ecosistema AI: MCP servers, archivos de contexto, skills y memorias",
+    {
+      dir: z.string().optional().describe("Directorio a escanear (default: cwd)"),
+      include_user: z.boolean().optional().describe("Incluir configuraci\xF3n del usuario"),
+      no_introspect: z.boolean().optional().describe("No conectar a MCP servers"),
+      timeout: z.number().optional().describe("Timeout de introspecci\xF3n en ms (default: 10000)")
+    },
+    async ({ dir, include_user, no_introspect, timeout }) => {
+      try {
+        const result = await runAllScanners({
+          dir: dir ?? process.cwd(),
+          includeUser: include_user ?? false,
+          introspect: !(no_introspect ?? false),
+          timeout: timeout ?? 1e4
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `Error escaneando: ${err.message}`
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
+// src/tools/introspect.ts
+import { z as z2 } from "zod";
+function registerIntrospectTool(server) {
+  server.tool(
+    "introspect_mcp",
+    "Introspecciona un MCP server espec\xEDfico: lista sus tools, resources y prompts",
+    {
+      server_name: z2.string().describe("Nombre del server MCP a introspeccionar"),
+      dir: z2.string().optional().describe("Directorio del proyecto (default: cwd)"),
+      timeout: z2.number().optional().describe("Timeout en ms (default: 10000)")
+    },
+    async ({ server_name, dir, timeout }) => {
+      try {
+        const { servers } = await scanMcpConfigs({
+          dir: dir ?? process.cwd(),
+          includeUser: true
+        });
+        const target = servers.find((s) => s.name === server_name);
+        if (!target) {
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: `Server '${server_name}' no encontrado en la configuraci\xF3n. Servers disponibles: ${servers.map((s) => s.name).join(", ") || "(ninguno)"}`
+              }
+            ]
+          };
+        }
+        await introspectServers([target], timeout ?? 1e4);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(target, null, 2)
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `Error introspectando: ${err.message}`
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
+// src/tools/report.ts
+import { z as z3 } from "zod";
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, resolve } from "path";
+function registerReportTool(server) {
+  server.tool(
+    "generate_report",
+    "Genera un dashboard HTML interactivo con el ecosistema AI del proyecto",
+    {
+      dir: z3.string().optional().describe("Directorio a escanear (default: cwd)"),
+      output: z3.string().optional().describe("Ruta del archivo HTML (default: ai-context-report.html)"),
+      no_introspect: z3.boolean().optional().describe("No conectar a MCP servers")
+    },
+    async ({ dir, output, no_introspect }) => {
+      try {
+        const result = await runAllScanners({
+          dir: dir ?? process.cwd(),
+          includeUser: false,
+          introspect: !(no_introspect ?? false),
+          timeout: 1e4
+        });
+        const html = generateHtml(result);
+        const outputPath = resolve(output ?? "ai-context-report.html");
+        await mkdir(dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, html, "utf-8");
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Reporte generado: ${outputPath}
+
+Resumen:
+- MCP Servers: ${result.mcpServers.length}
+- Tools: ${result.mcpServers.reduce((s, m) => s + (m.introspection?.tools.length ?? 0), 0)}
+- Archivos: ${result.contextFiles.length}
+- Skills: ${result.skills.length}
+- Memorias: ${result.memories.length}`
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          isError: true,
+          content: [
+            {
+              type: "text",
+              text: `Error generando reporte: ${err.message}`
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+
+// src/server.ts
+var VERSION = "0.1.0";
+function createServer() {
+  const server = new McpServer({
+    name: "ai-context-inspector",
+    version: VERSION
+  });
+  registerScanTool(server);
+  registerIntrospectTool(server);
+  registerReportTool(server);
+  return server;
+}
+export {
+  createServer
+};

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@cocaxcode/ai-context-inspector",
+  "version": "0.1.0",
+  "description": "Scan any project to discover its complete AI ecosystem: MCP servers, tools, context files, skills, memories. Generates an interactive HTML dashboard. Works as CLI and MCP server.",
+  "type": "module",
+  "bin": {
+    "ai-context-inspector": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "inspector": "npx @modelcontextprotocol/inspector node dist/index.js -- --mcp"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai-context",
+    "ai-inspector",
+    "ai-tools",
+    "mcp-introspection",
+    "claude",
+    "cursor",
+    "windsurf",
+    "copilot",
+    "gemini",
+    "codex",
+    "aider",
+    "cline",
+    "dashboard",
+    "html-report",
+    "context-files",
+    "skills",
+    "ai-ecosystem"
+  ],
+  "author": "cocaxcode",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cocaxcode/ai-context-inspector.git"
+  },
+  "homepage": "https://github.com/cocaxcode/ai-context-inspector#readme",
+  "bugs": {
+    "url": "https://github.com/cocaxcode/ai-context-inspector/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@vitest/coverage-v8": "^3.2.0",
+    "eslint": "^9.28.0",
+    "prettier": "^3.5.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.33.0",
+    "vitest": "^3.2.0"
+  }
+}