UCN

Provides static analysis and code navigation via an MCP server, exposing AST-verified commands for multiple languages.

other

0

GitHub Stars

other

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mleoca-ucn": {
      "command": "npx",
      "args": [
        "-y",
        "ucn",
        "--mcp"
      ]
    }
  }
}

You can run the UCN MCP server to expose 28 code-navigation commands locally, enabling AI agents and tooling to ask structure-based questions about your codebase without reading every file. This surgical output helps you reason about calls, dependencies, and impact with minimal context read, all while keeping your project data on your machine.

How to use

You can connect to the UCN MCP server from an MCP client to access 28 navigation commands. Use the MCP client to run commands like pulling a function, analyzing call graphs, tracing call trees, and performing impact assessments. The server runs locally and never sends your code to external services.

How to install

Prerequisites: ensure you have Node.js installed (for npm/npx) and a working shell.

npm install -g ucn

MCP server configuration and usage examples

To expose UCN as an MCP server, run it with the MCP flag. Then connect your MCP client using the provided command template.

# Claude Code integration
claude mcp add ucn -- npx -y ucn --mcp

# OpenAI Codex CLI integration
codex mcp add ucn -- npx -y ucn --mcp

# VS Code Copilot integration (JSON config snippet)
code --add-mcp '{"name":"ucn","command":"npx","args":["-y","ucn","--mcp"]}'

Agent skills and CLI usage

If you prefer a standalone CLI, you can use UCN without a server or agent. The CLI provides quick access to 28 commands directly from your terminal.

ucn toc
ucn about handleRequest
ucn impact handleRequest
ucn fn handleRequest --file api
ucn --interactive

Available tools

about

Understand everything in one call: definition, callers, callees, tests, and source.

context

Show callers and callees for quick overview of a function's usage.

smart

Extract a function with its dependencies inline, including dependencies.

trace

Trace a function to map the call tree and dependencies.

diff_impact

Diff impact: identify what changed and who is affected by a modification.

verify

Verify that changes preserve all call sites and behavior.

find

Locate definitions across the project.

usages

List all occurrences of a symbol.

fn

Extract a function from a large file.

class

Extract a class and its members.

deadcode

Identify unused code and potential cleanup opportunities.

search

Text search capabilities across code.

example

Show best usage examples for a function or API.

lines

Extract a specific range of lines from a file.

expand

Drill into the context around a symbol.

graph

Display a dependency graph for a file or module.

api

Inspect the public API surface of a module.

endpoints

List public endpoints or callable interfaces.

typedef

Show type definitions and aliases.

file_exports

Inspect a file's exports.

graph_services

Dependencies between services or modules.