universal-ast-mapper 1.5.0 → 1.6.0

package/README.md

@@ -562,6 +562,18 @@ src/
 
 ---
 
+## MCP resources
+
+Beyond tools, the server exposes the codebase as **browseable MCP resources**, so an agent (or MCP client UI) can list and read structure directly:
+
+| URI | What |
+|-----|------|
+| `ast://languages` | supported languages + extensions |
+| `ast://skeleton/{path}` | the skeleton for one source file (templated; `resources/list` enumerates every file) |
+| `ast://graph` | the whole-root symbol dependency graph (guarded by file count) |
+
+---
+
 ## GitHub Action — architecture gate in CI
 
 Use AST-MCP as a CI check with the bundled composite action (`action.yml`):
@@ -605,6 +617,7 @@ Not part of the public API: the internal `src/` module layout and the generated
 
 | Version | What changed |
 |---------|--------------|
+| **1.6.0** | **MCP resource endpoints** — the server now exposes browseable resources: `ast://languages`, `ast://skeleton/{path}` (templated, one per source file via `resources/list`), and `ast://graph`. Agents can list and read codebase structure as resources, not just call tools. |
 | **1.5.0** | **`.d.ts` / ambient declarations** — `declare function/const/class`, `declare module "x"`, and `declare namespace` (and plain `namespace`) are now extracted (previously a `.d.ts` yielded 0 symbols). Adds a `namespace` symbol kind; declared APIs surface as exported, nested under their module/namespace. |
 | **1.4.0** | **Dynamic import tracking** — dynamic `import("...")` and CommonJS `require("...")` calls (anywhere in a file) are now captured as imports with an `isDynamic` flag. Relative dynamic imports resolve and draw graph edges like static ones, so lazy-loaded routes/modules show up in the dependency graph. |
 | **1.3.0** | **TS/JS decorators** — class and method symbols now carry a `decorators` field (`@Component({...})`, `@Injectable()`, `@Get("/x")`), in skeletons and `get_call_graph`. Extends the Python decorator support (v0.8.7) to TypeScript/JavaScript — traces Angular/NestJS-style framework wiring to its class/handler. |

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import fs from "node:fs";
 import path from "node:path";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { fileURLToPath } from "node:url";
@@ -983,6 +983,71 @@ function describeError(err) {
     }
     return err instanceof Error ? err.message : String(err);
 }
+/* ─────────────────── MCP resources (browseable structure) ──────────────── */
+server.registerResource("languages", "ast://languages", {
+    title: "Supported languages",
+    description: "Languages and file extensions this server can map.",
+    mimeType: "application/json",
+}, async (uri) => ({
+    contents: [{
+            uri: uri.href,
+            mimeType: "application/json",
+            text: JSON.stringify({ root: ROOT, languages: supportedLanguages() }, null, 2),
+        }],
+}));
+server.registerResource("skeleton", new ResourceTemplate("ast://skeleton/{+path}", {
+    list: async () => {
+        const opts = resolveOptions({ detail: "outline", emitHtml: false });
+        const files = collectSourceFiles(ROOT, opts);
+        return {
+            resources: files.map((f) => {
+                const rel = path.relative(ROOT, f).split(path.sep).join("/");
+                return { uri: `ast://skeleton/${rel}`, name: rel, mimeType: "application/json" };
+            }),
+        };
+    },
+}), {
+    title: "File skeleton",
+    description: "Normalized code skeleton (symbols, imports, ranges) for one source file.",
+    mimeType: "application/json",
+}, async (uri, variables) => {
+    const rel = decodeURIComponent(String(variables.path)).split(path.sep).join("/");
+    const { abs, rel: safeRel } = resolveInRoot(rel);
+    const opts = resolveOptions({ detail: "outline", emitHtml: false });
+    const skel = await buildSkeleton(abs, safeRel.split(path.sep).join("/"), opts);
+    return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(skel, null, 2) }],
+    };
+});
+server.registerResource("graph", "ast://graph", {
+    title: "Symbol dependency graph",
+    description: "Symbol-level dependency graph for the whole root (guarded by node count).",
+    mimeType: "application/json",
+}, async (uri) => {
+    const opts = resolveOptions({ detail: "outline", emitHtml: false });
+    const files = collectSourceFiles(ROOT, opts);
+    if (files.length > 1500) {
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify({ note: `Too large to inline (${files.length} files). Use build_symbol_graph on a subdirectory.`, files: files.length }, null, 2),
+                }],
+        };
+    }
+    const skels = [];
+    for (const file of files) {
+        const fileRel = path.relative(ROOT, file).split(path.sep).join("/");
+        try {
+            skels.push(await buildSkeleton(file, fileRel, opts));
+        }
+        catch { /* skip */ }
+    }
+    const graph = buildSymbolGraph(skels, ROOT);
+    return {
+        contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(graph, null, 2) }],
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-ast-mapper",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "MCP server that maps source files into a normalized code skeleton (JSON + HTML) using tree-sitter.",
   "type": "module",
   "main": "dist/index.js",