# naja-scope

The naja-scope MCP server for Claude Code lets an agent inspect elaborated SystemVerilog and VHDL designs. It traces signal connections, explores module hierarchy, and returns RTL source locations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 22 repo stars
- Author: keplertech
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/keplertech/naja-scope
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/naja-scope

## What it does

naja-scope loads a design so an agent can inspect signals, modules, and their connections. It can trace drivers and loads across module boundaries, browse instances and ports, follow combinational logic cones to register boundaries, and return file-and-line references.

For gate-level work, it accepts a structural Verilog netlist together with a Liberty standard-cell library. Running it through `uvx` fetches `naja-scope` and `najaeda` from PyPI; a separate install step is unnecessary. A `pip` installation also needs `najaeda`, version 0.7.35 or newer.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add naja-scope -- uvx naja-scope
```
uvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>

### Codex

**Platform CLI**
```bash
codex mcp add naja-scope -- uvx naja-scope
```
uvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "naja-scope": {
            "command": "uvx",
            "args": [
                "naja-scope"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "naja-scope": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "naja-scope"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add naja-scope uvx naja-scope
```
uvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>

## When to use it
- trace the drivers or loads connected to a signal
- inspect instances and ports across module hierarchy
- find RTL file locations for design elements
- follow combinational logic to a register boundary
- explore a gate-level netlist with its Liberty library

## Example prompts
- Load `rtl/uart.sv` with top `uart_top` and show what drives `tx_o`.
- List the instances and ports inside `ex_stage_i`.
- Trace the combinational fan-in of this signal up to the register boundary.

## Similar
- [pyslang-mcp](https://affpapa.org/en/nevibecode/mcp/pyslang-mcp.md) — MCP server · ★ 24 repo stars
- [systemverilog](https://affpapa.org/en/nevibecode/skills/systemverilog.md) — skill · 1100 installs
- [verilog-basics-for-lowlevel](https://affpapa.org/en/nevibecode/skills/verilog-basics-for-lowlevel.md) — skill · 345 installs
- [fpga](https://affpapa.org/en/nevibecode/skills/fpga.md) — skill · 1100 installs
- [neosyn-fpga-mcp](https://affpapa.org/en/nevibecode/mcp/neosyn-fpga-mcp.md) — MCP server · ★ 1 repo stars
- [Silica](https://affpapa.org/en/nevibecode/mcp/silica.md) — MCP server · ★ 13 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
