@depxray/mcp 1.3.0

package/README.md

@@ -0,0 +1,111 @@
+# @depxray/mcp
+
+Give AI coding agents dependency-aware context before they edit your code.
+
+`@depxray/mcp` is the Model Context Protocol server for depxray. It lets MCP-compatible clients such as Claude Desktop, Cursor, and other coding agents inspect JavaScript and TypeScript projects through static dependency analysis.
+
+Use it when an agent needs to answer questions like:
+
+- What does this file import?
+- What files depend on this file?
+- Are there circular dependencies?
+- Which files appear to be orphaned?
+- What is inside this folder?
+- What does the project dependency graph look like?
+
+The server runs locally over stdio and uses `@depxray/core`, the same scanner that powers the `depxray` CLI and browser UI.
+
+## Quick Start
+
+```bash
+npx @depxray/mcp
+```
+
+Most users do not run this command directly. Add it to your MCP client configuration so the client can start the server when needed.
+
+## Why Use This
+
+- Help coding agents understand a repository before making edits
+- Inspect imports and dependents for a target file
+- Find circular dependencies before refactors
+- Find orphan files that may be safe cleanup candidates
+- Summarize folder-level dependency relationships
+- Produce machine-readable project structure and dependency graph context
+
+`@depxray/mcp` is especially useful for agentic coding workflows where the agent should inspect dependency impact before changing source files.
+
+## Claude Desktop Setup
+
+Add this to your Claude Desktop MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "depxray": {
+      "command": "npx",
+      "args": ["@depxray/mcp"]
+    }
+  }
+}
+```
+
+## Cursor Setup
+
+Add a new MCP server with:
+
+```json
+{
+  "command": "npx",
+  "args": ["@depxray/mcp"]
+}
+```
+
+## Agent Workflow Example
+
+A coding agent can use the tools in this order before editing:
+
+1. Call `get_file_tree` to understand the project layout.
+2. Call `inspect_file` for the file it plans to modify.
+3. Call `get_folder_summary` for the surrounding folder.
+4. Call `find_circular` or `find_orphans` when planning a refactor.
+5. Call `scan_project` when it needs full graph context.
+
+This gives the agent a clearer view of dependency impact before it changes code.
+
+## Tools
+
+| Tool | Use When | Example Input |
+| --- | --- | --- |
+| `scan_project` | The agent needs full structure or dependency graph data. | `{ "rootDir": "/path/to/project", "mode": "dependencies" }` |
+| `inspect_file` | The agent needs imports, dependents, and metrics for one file. | `{ "rootDir": "/path/to/project", "filePath": "src/App.tsx" }` |
+| `find_circular` | The agent should detect dependency cycles before a refactor. | `{ "rootDir": "/path/to/project" }` |
+| `find_orphans` | The agent should find files with no incoming references. | `{ "rootDir": "/path/to/project" }` |
+| `get_file_tree` | The agent needs a compact project tree. | `{ "rootDir": "/path/to/project", "maxDepth": 3 }` |
+| `get_folder_summary` | The agent needs folder-level dependency metrics. | `{ "rootDir": "/path/to/project", "folderPath": "src/components" }` |
+
+`scan_project` supports `mode: "dependencies"` and `mode: "structure"`. Dependency mode returns imports, circular counts, orphan files, and graph edges. Structure mode returns directory and file parent-child graph data.
+
+## Supported Projects
+
+`@depxray/mcp` analyzes JavaScript and TypeScript projects with:
+
+- `.js`, `.jsx`, `.ts`, and `.tsx` files
+- static imports
+- type-only imports
+- dynamic imports
+- CommonJS `require`
+- re-exports and barrel files
+- `tsconfig.json` and `jsconfig.json` path aliases
+
+## Privacy
+
+The MCP server runs locally and performs static analysis on files in the project paths provided by the MCP client. It does not send your source code to depxray or any external depxray service.
+
+Your MCP client may still send tool results to its own model provider. Review your client configuration and provider policy if you are working with private code.
+
+## Relationship To `depxray`
+
+This package is the MCP interface for depxray.
+
+- Use `npx depxray scan` for the browser UI, CLI JSON output, and static HTML reports.
+- Use `npx @depxray/mcp` when an MCP-compatible AI coding agent needs depxray tools.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createDepxrayMcpServer(): McpServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,wBAAgB,sBAAsB,IAAI,SAAS,CAoFlD"}

package/dist/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { findCircularTool } from './tools/findCircular.js';
+import { findOrphansTool } from './tools/findOrphans.js';
+import { getFileTreeTool } from './tools/getFileTree.js';
+import { getFolderSummaryTool } from './tools/getFolderSummary.js';
+import { inspectFileTool } from './tools/inspectFile.js';
+import { scanProjectTool } from './tools/scanProject.js';
+import { jsonContent } from './tools/shared.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const rootDirSchema = z.string().min(1).describe('Absolute or relative project root directory.');
+export function createDepxrayMcpServer() {
+    const server = new McpServer({
+        name: 'depxray',
+        version: packageJson.version,
+    });
+    server.registerTool('scan_project', {
+        title: 'Scan project',
+        description: 'Scan a project and return graph data for structure or dependency analysis.',
+        inputSchema: {
+            rootDir: rootDirSchema,
+            mode: z.enum(['structure', 'dependencies']).optional().describe('Graph mode to return. Defaults to dependencies.'),
+        },
+    }, async (input) => jsonContent(await scanProjectTool(input)));
+    server.registerTool('inspect_file', {
+        title: 'Inspect file',
+        description: 'Return imports, dependents, and dependency metrics for one project file.',
+        inputSchema: {
+            filePath: z.string().min(1).describe('File path to inspect. Relative paths resolve from rootDir.'),
+            rootDir: rootDirSchema.optional().describe('Project root directory. Defaults to the MCP process working directory.'),
+        },
+    }, async (input) => jsonContent(await inspectFileTool(input)));
+    server.registerTool('find_circular', {
+        title: 'Find circular dependencies',
+        description: 'Find circular dependency chains in a project.',
+        inputSchema: {
+            rootDir: rootDirSchema,
+        },
+    }, async (input) => jsonContent(await findCircularTool(input)));
+    server.registerTool('find_orphans', {
+        title: 'Find orphan files',
+        description: 'Find source files with no inbound dependency references, excluding configured entry points.',
+        inputSchema: {
+            rootDir: rootDirSchema,
+            entryPointPatterns: z.array(z.string().min(1)).optional().describe('Optional glob patterns to exclude entry points from orphan results.'),
+        },
+    }, async (input) => jsonContent(await findOrphansTool(input)));
+    server.registerTool('get_file_tree', {
+        title: 'Get file tree',
+        description: 'Return the project file tree, optionally limited by traversal depth.',
+        inputSchema: {
+            rootDir: rootDirSchema,
+            maxDepth: z.number().int().nonnegative().optional().describe('Maximum folder depth to scan.'),
+        },
+    }, async (input) => jsonContent(await getFileTreeTool(input)));
+    server.registerTool('get_folder_summary', {
+        title: 'Get folder summary',
+        description: 'Return dependency metrics for a folder, including internal, incoming, outgoing, circular, and orphan references.',
+        inputSchema: {
+            rootDir: rootDirSchema,
+            folderPath: z.string().min(1).describe('Folder path to summarize. Relative paths resolve from rootDir.'),
+        },
+    }, async (input) => jsonContent(await getFolderSummaryTool(input)));
+    return server;
+}
+async function main() {
+    const server = createDepxrayMcpServer();
+    await server.connect(new StdioServerTransport());
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    main().catch((error) => {
+        const message = error instanceof Error ? error.stack ?? error.message : String(error);
+        console.error(message);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/findCircular.d.ts

@@ -0,0 +1,8 @@
+export interface FindCircularInput {
+    rootDir: string;
+}
+export declare function findCircularTool(input: FindCircularInput): Promise<{
+    count: number;
+    chains: import("@depxray/core").CircularChain[];
+}>;
+//# sourceMappingURL=findCircular.d.ts.map

package/dist/tools/findCircular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findCircular.d.ts","sourceRoot":"","sources":["../../src/tools/findCircular.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB;;;GAQ9D"}

package/dist/tools/findCircular.js

@@ -0,0 +1,11 @@
+import { scanProject } from '@depxray/core';
+import { resolveRootDir } from './shared.js';
+export async function findCircularTool(input) {
+    const rootDir = resolveRootDir(input.rootDir);
+    const result = await scanProject({ rootDir, detectCircular: true });
+    return {
+        count: result.graph.circularDependencies.length,
+        chains: result.graph.circularDependencies,
+    };
+}
+//# sourceMappingURL=findCircular.js.map

package/dist/tools/findCircular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findCircular.js","sourceRoot":"","sources":["../../src/tools/findCircular.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAM7C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAwB;IAC7D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,MAAM;QAC/C,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,oBAAoB;KAC1C,CAAC;AACJ,CAAC"}

package/dist/tools/findOrphans.d.ts

@@ -0,0 +1,9 @@
+export interface FindOrphansInput {
+    rootDir: string;
+    entryPointPatterns?: string[];
+}
+export declare function findOrphansTool(input: FindOrphansInput): Promise<{
+    count: number;
+    orphanFiles: string[];
+}>;
+//# sourceMappingURL=findOrphans.d.ts.map

package/dist/tools/findOrphans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findOrphans.d.ts","sourceRoot":"","sources":["../../src/tools/findOrphans.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB;;;GAY5D"}

package/dist/tools/findOrphans.js

@@ -0,0 +1,15 @@
+import { scanProject } from '@depxray/core';
+import { resolveRootDir } from './shared.js';
+export async function findOrphansTool(input) {
+    const rootDir = resolveRootDir(input.rootDir);
+    const result = await scanProject({
+        rootDir,
+        detectCircular: true,
+        entryPointPatterns: input.entryPointPatterns,
+    });
+    return {
+        count: result.orphanFiles.length,
+        orphanFiles: result.orphanFiles,
+    };
+}
+//# sourceMappingURL=findOrphans.js.map

package/dist/tools/findOrphans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findOrphans.js","sourceRoot":"","sources":["../../src/tools/findOrphans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAuB;IAC3D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,OAAO;QACP,cAAc,EAAE,IAAI;QACpB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;QAChC,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC"}

package/dist/tools/getFileTree.d.ts

@@ -0,0 +1,6 @@
+export interface GetFileTreeInput {
+    rootDir: string;
+    maxDepth?: number;
+}
+export declare function getFileTreeTool(input: GetFileTreeInput): Promise<import("@depxray/core").FileTreeNode>;
+//# sourceMappingURL=getFileTree.d.ts.map

package/dist/tools/getFileTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFileTree.d.ts","sourceRoot":"","sources":["../../src/tools/getFileTree.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,iDAI5D"}

package/dist/tools/getFileTree.js

@@ -0,0 +1,8 @@
+import { scanFileTree } from '@depxray/core';
+import { resolveRootDir } from './shared.js';
+export async function getFileTreeTool(input) {
+    return scanFileTree(resolveRootDir(input.rootDir), {
+        maxDepth: input.maxDepth ?? Infinity,
+    });
+}
+//# sourceMappingURL=getFileTree.js.map

package/dist/tools/getFileTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFileTree.js","sourceRoot":"","sources":["../../src/tools/getFileTree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAuB;IAC3D,OAAO,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;QACjD,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/getFolderSummary.d.ts

@@ -0,0 +1,27 @@
+export interface GetFolderSummaryInput {
+    rootDir: string;
+    folderPath: string;
+}
+export declare function getFolderSummaryTool(input: GetFolderSummaryInput): Promise<{
+    folder: string;
+    absolutePath: string;
+    directChildren: number;
+    descendants: number;
+    totalFiles: number;
+    internalImports: number;
+    incomingExternalRefs: number;
+    outgoingExternalRefs: number;
+    circularFiles: string[];
+    orphanFiles: string[];
+    incomingExternal: {
+        source: string;
+        target: string;
+        specifier: string;
+    }[];
+    outgoingExternal: {
+        source: string;
+        target: string;
+        specifier: string;
+    }[];
+}>;
+//# sourceMappingURL=getFolderSummary.d.ts.map

package/dist/tools/getFolderSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFolderSummary.d.ts","sourceRoot":"","sources":["../../src/tools/getFolderSummary.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;GAkEtE"}

package/dist/tools/getFolderSummary.js

@@ -0,0 +1,58 @@
+import * as path from 'node:path';
+import { scanFileTree, scanProject, } from '@depxray/core';
+import { assertPathInsideRoot, flattenTree, resolveProjectPath, resolveRootDir, } from './shared.js';
+export async function getFolderSummaryTool(input) {
+    const rootDir = resolveRootDir(input.rootDir);
+    const folderAbsolutePath = resolveProjectPath(rootDir, input.folderPath);
+    assertPathInsideRoot(rootDir, folderAbsolutePath);
+    const [tree, result] = await Promise.all([
+        scanFileTree(rootDir),
+        scanProject({ rootDir, detectCircular: true }),
+    ]);
+    const allTreeNodes = flattenTree(tree);
+    const folderNode = allTreeNodes.find((node) => node.absolutePath === folderAbsolutePath);
+    if (!folderNode) {
+        throw new Error(`Folder not found: ${input.folderPath}`);
+    }
+    if (folderNode.kind !== 'directory') {
+        throw new Error(`Not a directory: ${input.folderPath}`);
+    }
+    const fileIds = new Set(result.graph.nodes
+        .filter((node) => {
+        const relative = path.relative(folderAbsolutePath, node.id);
+        return relative === '' || (!relative.startsWith('..') && !path.isAbsolute(relative));
+    })
+        .map((node) => node.id));
+    const circularFiles = result.graph.nodes
+        .filter((node) => fileIds.has(node.id) && node.isCircular)
+        .map((node) => node.relativePath);
+    const orphanFiles = result.graph.nodes
+        .filter((node) => fileIds.has(node.id) && result.orphanFiles.includes(node.relativePath))
+        .map((node) => node.relativePath);
+    const internalImports = result.graph.edges.filter((edge) => (fileIds.has(edge.source) && fileIds.has(edge.target)));
+    const incomingExternal = result.graph.edges.filter((edge) => (!fileIds.has(edge.source) && fileIds.has(edge.target)));
+    const outgoingExternal = result.graph.edges.filter((edge) => (fileIds.has(edge.source) && !fileIds.has(edge.target)));
+    return {
+        folder: folderNode.relativePath,
+        absolutePath: folderNode.absolutePath,
+        directChildren: folderNode.children.length,
+        descendants: flattenTree(folderNode).length - 1,
+        totalFiles: fileIds.size,
+        internalImports: internalImports.length,
+        incomingExternalRefs: incomingExternal.length,
+        outgoingExternalRefs: outgoingExternal.length,
+        circularFiles,
+        orphanFiles,
+        incomingExternal: incomingExternal.map((edge) => ({
+            source: path.relative(rootDir, edge.source),
+            target: path.relative(rootDir, edge.target),
+            specifier: edge.importSpecifier,
+        })),
+        outgoingExternal: outgoingExternal.map((edge) => ({
+            source: path.relative(rootDir, edge.source),
+            target: path.relative(rootDir, edge.target),
+            specifier: edge.importSpecifier,
+        })),
+    };
+}
+//# sourceMappingURL=getFolderSummary.js.map

package/dist/tools/getFolderSummary.js.map

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

package/dist/tools/inspectFile.d.ts

@@ -0,0 +1,30 @@
+export interface InspectFileInput {
+    filePath: string;
+    rootDir?: string;
+}
+export declare function inspectFileTool(input: InspectFileInput): Promise<{
+    file: string;
+    absolutePath: string;
+    extension: string;
+    inDegree: number;
+    outDegree: number;
+    isCircular: boolean;
+    isOrphan: boolean;
+    imports: {
+        file: string;
+        absolutePath: string;
+        specifier: string;
+        names: string[];
+        isTypeOnly: boolean;
+        isDynamic: boolean;
+    }[];
+    dependents: {
+        file: string;
+        absolutePath: string;
+        specifier: string;
+        names: string[];
+        isTypeOnly: boolean;
+        isDynamic: boolean;
+    }[];
+}>;
+//# sourceMappingURL=inspectFile.d.ts.map

package/dist/tools/inspectFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectFile.d.ts","sourceRoot":"","sources":["../../src/tools/inspectFile.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;GA6C5D"}

package/dist/tools/inspectFile.js

@@ -0,0 +1,48 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { scanProject } from '@depxray/core';
+import { assertPathInsideRoot, resolveProjectPath, resolveRootDir, } from './shared.js';
+export async function inspectFileTool(input) {
+    const rootDir = resolveRootDir(input.rootDir ?? process.cwd());
+    const filePath = resolveProjectPath(rootDir, input.filePath);
+    assertPathInsideRoot(rootDir, filePath);
+    try {
+        await fs.access(filePath);
+    }
+    catch {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    const result = await scanProject({ rootDir, detectCircular: true });
+    const node = result.graph.nodes.find((graphNode) => graphNode.id === filePath);
+    if (!node) {
+        throw new Error(`File not found in dependency graph: ${input.filePath}`);
+    }
+    const imports = result.graph.edges.filter((edge) => edge.source === filePath);
+    const dependents = result.graph.edges.filter((edge) => edge.target === filePath);
+    return {
+        file: node.relativePath,
+        absolutePath: node.id,
+        extension: node.extension,
+        inDegree: node.inDegree,
+        outDegree: node.outDegree,
+        isCircular: node.isCircular,
+        isOrphan: result.orphanFiles.includes(node.relativePath),
+        imports: imports.map((edge) => ({
+            file: path.relative(rootDir, edge.target),
+            absolutePath: edge.target,
+            specifier: edge.importSpecifier,
+            names: edge.importedNames,
+            isTypeOnly: edge.isTypeOnly,
+            isDynamic: edge.isDynamic,
+        })),
+        dependents: dependents.map((edge) => ({
+            file: path.relative(rootDir, edge.source),
+            absolutePath: edge.source,
+            specifier: edge.importSpecifier,
+            names: edge.importedNames,
+            isTypeOnly: edge.isTypeOnly,
+            isDynamic: edge.isDynamic,
+        })),
+    };
+}
+//# sourceMappingURL=inspectFile.js.map

package/dist/tools/inspectFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectFile.js","sourceRoot":"","sources":["../../src/tools/inspectFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AAOrB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAuB;IAC3D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7D,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC/E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC9E,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAEjF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,YAAY;QACvB,YAAY,EAAE,IAAI,CAAC,EAAE;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;QACxD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;YACzC,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,SAAS,EAAE,IAAI,CAAC,eAAe;YAC/B,KAAK,EAAE,IAAI,CAAC,aAAa;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;YACzC,YAAY,EAAE,IAAI,CAAC,MAAM;YACzB,SAAS,EAAE,IAAI,CAAC,eAAe;YAC/B,KAAK,EAAE,IAAI,CAAC,aAAa;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/scanProject.d.ts

@@ -0,0 +1,7 @@
+import type { GraphMode } from './shared.js';
+export interface ScanProjectInput {
+    rootDir: string;
+    mode?: GraphMode;
+}
+export declare function scanProjectTool(input: ScanProjectInput): Promise<import("./shared.js").ExplorerGraphData>;
+//# sourceMappingURL=scanProject.d.ts.map

package/dist/tools/scanProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanProject.d.ts","sourceRoot":"","sources":["../../src/tools/scanProject.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,oDAW5D"}

package/dist/tools/scanProject.js

@@ -0,0 +1,13 @@
+import { buildStructureGraph, scanFileTree, scanProject, } from '@depxray/core';
+import { resolveRootDir, toDependencyGraphData, toStructureGraphData, } from './shared.js';
+export async function scanProjectTool(input) {
+    const rootDir = resolveRootDir(input.rootDir);
+    const mode = input.mode ?? 'dependencies';
+    if (mode === 'structure') {
+        const tree = await scanFileTree(rootDir);
+        return toStructureGraphData(buildStructureGraph(tree));
+    }
+    const result = await scanProject({ rootDir, detectCircular: true });
+    return toDependencyGraphData(result);
+}
+//# sourceMappingURL=scanProject.js.map

package/dist/tools/scanProject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanProject.js","sourceRoot":"","sources":["../../src/tools/scanProject.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAOrB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAuB;IAC3D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,cAAc,CAAC;IAE1C,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,oBAAoB,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/tools/shared.d.ts

@@ -0,0 +1,44 @@
+import type { FileTreeNode, ScanError, ScanResult, StructureGraph, StructureGraphEdge, StructureGraphNode } from '@depxray/core';
+export type GraphMode = 'structure' | 'dependencies';
+export interface ExplorerGraphNode extends StructureGraphNode {
+    inDegree?: number;
+    outDegree?: number;
+    isCircular?: boolean;
+    isOrphan?: boolean;
+    componentName?: string;
+}
+export interface ExplorerGraphEdge extends StructureGraphEdge {
+    kind: GraphMode;
+    importSpecifier?: string;
+    importedNames?: string[];
+    isTypeOnly?: boolean;
+    isDynamic?: boolean;
+}
+export interface ExplorerGraphData {
+    schemaVersion: string;
+    mode: GraphMode;
+    projectRoot: string;
+    scannedAt: string;
+    totalFiles: number;
+    totalDirs: number;
+    totalImports: number;
+    circularCount: number;
+    orphanFiles: string[];
+    generatedBy: string;
+    errors: ScanError[];
+    nodes: ExplorerGraphNode[];
+    edges: ExplorerGraphEdge[];
+}
+export declare function resolveRootDir(rootDir: string): string;
+export declare function resolveProjectPath(rootDir: string, targetPath: string): string;
+export declare function assertPathInsideRoot(rootDir: string, targetPath: string): void;
+export declare function jsonContent(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function toStructureGraphData(graph: StructureGraph): ExplorerGraphData;
+export declare function toDependencyGraphData(result: ScanResult): ExplorerGraphData;
+export declare function flattenTree(rootNode: FileTreeNode): FileTreeNode[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAKvB,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAErD,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,IAAI,EAAE,SAAS,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAID,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAK9E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO;;;;;EASxC;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAuB7E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,iBAAiB,CA+C3E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,EAAE,CAYlE"}

package/dist/tools/shared.js

@@ -0,0 +1,113 @@
+import * as path from 'node:path';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const packageJson = require('../../package.json');
+const EXPORT_SCHEMA_VERSION = '1.0.0';
+export function resolveRootDir(rootDir) {
+    return path.resolve(rootDir);
+}
+export function resolveProjectPath(rootDir, targetPath) {
+    return path.isAbsolute(targetPath)
+        ? path.resolve(targetPath)
+        : path.resolve(rootDir, targetPath);
+}
+export function assertPathInsideRoot(rootDir, targetPath) {
+    const relative = path.relative(rootDir, targetPath);
+    if (relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error(`Path is outside project root: ${targetPath}`);
+    }
+}
+export function jsonContent(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+function getGeneratedBy() {
+    return `@depxray/mcp@${packageJson.version}`;
+}
+export function toStructureGraphData(graph) {
+    const scannedAt = new Date().toISOString();
+    const totalFiles = graph.nodes.filter((node) => node.kind === 'file').length;
+    const totalDirs = graph.nodes.filter((node) => node.kind === 'directory').length;
+    return {
+        schemaVersion: EXPORT_SCHEMA_VERSION,
+        mode: 'structure',
+        projectRoot: graph.rootDir,
+        scannedAt,
+        totalFiles,
+        totalDirs,
+        totalImports: 0,
+        circularCount: 0,
+        orphanFiles: [],
+        generatedBy: getGeneratedBy(),
+        errors: [],
+        nodes: graph.nodes,
+        edges: graph.edges.map((edge) => ({
+            ...edge,
+            kind: 'structure',
+        })),
+    };
+}
+export function toDependencyGraphData(result) {
+    const orphanFileSet = new Set(result.orphanFiles);
+    const nodes = result.graph.nodes.map((node) => ({
+        id: node.id,
+        label: path.basename(node.relativePath),
+        relativePath: node.relativePath,
+        absolutePath: node.id,
+        kind: 'file',
+        extension: node.extension,
+        depth: Math.max(1, node.relativePath.split(/[/\\]/).filter(Boolean).length),
+        collapsed: false,
+        hidden: false,
+        childCount: node.outDegree,
+        descendantCount: Math.max(node.inDegree, node.outDegree),
+        inDegree: node.inDegree,
+        outDegree: node.outDegree,
+        isCircular: node.isCircular,
+        isOrphan: orphanFileSet.has(node.relativePath),
+        ...(node.componentName ? { componentName: node.componentName } : {}),
+    }));
+    const edges = result.graph.edges.map((edge, index) => ({
+        id: `${edge.source}->${edge.target}-${index}`,
+        source: edge.source,
+        target: edge.target,
+        kind: 'dependencies',
+        importSpecifier: edge.importSpecifier,
+        importedNames: edge.importedNames,
+        isTypeOnly: edge.isTypeOnly,
+        isDynamic: edge.isDynamic,
+    }));
+    return {
+        schemaVersion: EXPORT_SCHEMA_VERSION,
+        mode: 'dependencies',
+        projectRoot: result.graph.rootDir,
+        scannedAt: result.graph.metadata.scannedAt,
+        totalFiles: result.totalFiles,
+        totalDirs: 0,
+        totalImports: result.totalImports,
+        circularCount: result.circularCount,
+        orphanFiles: result.orphanFiles,
+        generatedBy: getGeneratedBy(),
+        errors: result.errors,
+        nodes,
+        edges,
+    };
+}
+export function flattenTree(rootNode) {
+    const nodes = [];
+    function visit(node) {
+        nodes.push(node);
+        for (const child of node.children) {
+            visit(child);
+        }
+    }
+    visit(rootNode);
+    return nodes;
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@depxray/mcp",
+  "version": "1.3.0",
+  "description": "MCP server for depxray dependency analysis and AI-agent codebase context.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "depxray-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "node ../../scripts/sync-versions.mjs && npm run build"
+  },
+  "dependencies": {
+    "@depxray/core": "1.3.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "dependency-graph",
+    "static-analysis",
+    "codebase-context",
+    "ai-agent",
+    "coding-agent",
+    "agentic-ai",
+    "llm",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Pannawish Kriengyakul",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pannawish/depxray.git"
+  }
+}