ucn 3.4.4 → 3.4.6

package/README.md

@@ -134,45 +134,31 @@ EXTERNAL:
   fs, path, crypto
 ```
 
-## Supported Languages
-
-JavaScript, TypeScript, Python, Go, Rust, Java
-
-## Install
+## Workflows
 
+**Investigating a bug:**
 ```bash
-npm install -g ucn
+ucn about problematic_function          # Understand it fully
+ucn trace problematic_function --depth=2  # See what it calls
 ```
 
-### Claude Code (optional)
-
-To use UCN as a skill in Claude Code:
-
+**Before modifying a function:**
 ```bash
-mkdir -p ~/.claude/skills
-
-# If installed via npm:
-cp -r "$(npm root -g)/ucn/.claude/skills/ucn" ~/.claude/skills/
-
-# If cloned from git:
-git clone https://github.com/mleoca/ucn.git
-cp -r ucn/.claude/skills/ucn ~/.claude/skills/
+ucn impact the_function                 # Who will break?
+ucn smart the_function                  # See it + its helpers
+# ... make your changes ...
+ucn verify the_function                 # Did all call sites survive?
 ```
 
-### Codex (optional)
-
-To use UCN as a skill in OpenAI Codex:
-
+**Periodic cleanup:**
 ```bash
-mkdir -p ~/.agents/skills
+ucn deadcode --exclude=test             # What can be deleted?
+ucn toc                                 # Project overview
+```
 
-# If installed via npm:
-cp -r "$(npm root -g)/ucn/.claude/skills/ucn" ~/.agents/skills/
+## Supported Languages
 
-# If cloned from git:
-git clone https://github.com/mleoca/ucn.git
-cp -r ucn/.claude/skills/ucn ~/.agents/skills/
-```
+JavaScript, TypeScript, Python, Go, Rust, Java
 
 ## Usage
 
@@ -257,6 +243,7 @@ Common Flags:
   --clear-cache       Clear cache before running
   --no-follow-symlinks  Don't follow symbolic links
   -i, --interactive   Keep index in memory for multiple queries
+  --mcp               Start as MCP server (stdio transport)
 
 Quick Start:
   ucn toc                             # See project structure (compact)
@@ -267,26 +254,85 @@ Quick Start:
   ucn --interactive                   # Multiple queries
 ```
 
-## Workflows
+## Install
 
-**Investigating a bug:**
 ```bash
-ucn about problematic_function          # Understand it fully
-ucn trace problematic_function --depth=2  # See what it calls
+npm install -g ucn
 ```
 
-**Before modifying a function:**
+### MCP Server
+
+UCN includes a built-in [MCP](https://modelcontextprotocol.io) server, so any MCP-compatible AI client can use it as a tool. It exposes 27 tools (`ucn_about`, `ucn_context`, `ucn_impact`, `ucn_smart`, `ucn_trace`, `ucn_find`, `ucn_usages`, `ucn_toc`, `ucn_deadcode`, `ucn_fn`, `ucn_class`, `ucn_verify`, `ucn_imports`, `ucn_exporters`, `ucn_tests`, `ucn_related`, `ucn_graph`, `ucn_file_exports`, `ucn_search`, `ucn_plan`, `ucn_typedef`, `ucn_stacktrace`, `ucn_example`, `ucn_expand`, `ucn_lines`, `ucn_api`, `ucn_stats`).
+
+**One-line setup** (for clients that support it):
+
+| Client | Command |
+|--------|---------|
+| Claude Code | `claude mcp add ucn -- npx -y ucn --mcp` |
+| OpenAI Codex CLI | `codex mcp add ucn -- npx -y ucn --mcp` |
+| VS Code Copilot | `code --add-mcp '{"name":"ucn","command":"npx","args":["-y","ucn","--mcp"]}'` |
+
+**Manual config** — add to the appropriate config file for your client:
+
+| Client | Config file |
+|--------|-------------|
+| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) |
+| Cursor | `~/.cursor/mcp.json` or `.cursor/mcp.json` in project |
+| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
+| Cline | VS Code sidebar > MCP Servers > Configure |
+| Claude Code | `~/.claude/mcp-config.json` |
+
+```json
+{
+  "mcpServers": {
+    "ucn": {
+      "command": "npx",
+      "args": ["-y", "ucn", "--mcp"]
+    }
+  }
+}
+```
+
+<details>
+<summary>VS Code Copilot uses a slightly different format (<code>.vscode/mcp.json</code>)</summary>
+
+```json
+{
+  "servers": {
+    "ucn": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "ucn", "--mcp"]
+    }
+  }
+}
+```
+</details>
+
+### Claude Code Skill (alternative to MCP)
+
 ```bash
-ucn impact the_function                 # Who will break?
-ucn smart the_function                  # See it + its helpers
-# ... make your changes ...
-ucn verify the_function                 # Did all call sites survive?
+mkdir -p ~/.claude/skills
+
+# If installed via npm:
+cp -r "$(npm root -g)/ucn/.claude/skills/ucn" ~/.claude/skills/
+
+# If cloned from git:
+git clone https://github.com/mleoca/ucn.git
+cp -r ucn/.claude/skills/ucn ~/.claude/skills/
 ```
 
-**Periodic cleanup:**
+### Codex Skill (alternative to MCP)
+
 ```bash
-ucn deadcode --exclude=test             # What can be deleted?
-ucn toc                                 # Project overview
+mkdir -p ~/.agents/skills
+
+# If installed via npm:
+cp -r "$(npm root -g)/ucn/.claude/skills/ucn" ~/.agents/skills/
+
+# If cloned from git:
+git clone https://github.com/mleoca/ucn.git
+cp -r ucn/.claude/skills/ucn ~/.agents/skills/
 ```
 
 ## License

package/cli/index.js

@@ -22,6 +22,10 @@ const output = require('../core/output');
 
 const rawArgs = process.argv.slice(2);
 
+// MCP server mode — launch server and skip CLI
+if (rawArgs.includes('--mcp')) {
+    require('../mcp/server.js');
+} else {
 // Support -- to separate flags from positional arguments
 const doubleDashIdx = rawArgs.indexOf('--');
 const args = doubleDashIdx === -1 ? rawArgs : rawArgs.slice(0, doubleDashIdx);
@@ -78,7 +82,7 @@ if (fileArgIdx !== -1 && args[fileArgIdx + 1]) {
 
 // Known flags for validation
 const knownFlags = new Set([
-    '--help', '-h',
+    '--help', '-h', '--mcp',
     '--json', '--verbose', '--no-quiet', '--quiet',
     '--code-only', '--with-types', '--top-level', '--exact',
     '--no-cache', '--clear-cache', '--include-tests',
@@ -2542,3 +2546,5 @@ if (flags.interactive) {
 } else {
     main();
 }
+
+} // end of --mcp else block

package/core/discovery.js

@@ -298,7 +298,8 @@ function shouldIgnore(name, ignores, parentDir) {
     }
 
     // Check conditional ignores (only if parentDir provided)
-    if (parentDir && CONDITIONAL_IGNORES[name]) {
+    // Use Array.isArray to avoid matching Object.prototype properties (e.g. dir named "constructor")
+    if (parentDir && Array.isArray(CONDITIONAL_IGNORES[name])) {
         const markers = CONDITIONAL_IGNORES[name];
         for (const marker of markers) {
             if (fs.existsSync(path.join(parentDir, marker))) {

package/core/project.js

@@ -1803,7 +1803,7 @@ class ProjectIndex {
         // Find all test files
         const testFiles = [];
         for (const [filePath, fileEntry] of this.files) {
-            if (isTestFile(filePath, fileEntry.language)) {
+            if (isTestFile(fileEntry.relativePath, fileEntry.language)) {
                 testFiles.push({ path: filePath, entry: fileEntry });
             }
         }
@@ -2108,14 +2108,13 @@ class ProjectIndex {
                     continue;
                 }
 
+                const fileEntry = this.files.get(symbol.file);
+                const lang = fileEntry?.language;
+
                 // Skip test files unless requested
-                if (!options.includeTests && isTestFile(symbol.file, symbol.language)) {
+                if (!options.includeTests && isTestFile(symbol.relativePath, lang)) {
                     continue;
                 }
-
-                // Check if exported
-                const fileEntry = this.files.get(symbol.file);
-                const lang = fileEntry?.language;
                 const mods = symbol.modifiers || [];
 
                 // Language-specific entry points (called by runtime, no AST-visible callers)
@@ -3653,7 +3652,7 @@ class ProjectIndex {
             totalState += state.length;
             totalLines += fileEntry.lines;
             totalDynamic += fileEntry.dynamicImports || 0;
-            if (isTestFile(filePath)) totalTests += 1;
+            if (isTestFile(fileEntry.relativePath, fileEntry.language)) totalTests += 1;
 
             const entry = {
                 file: fileEntry.relativePath,