naja-scope — Claude Code MCP server: features and setup
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.
Apache-2.0 ★ 22 updated 2026-11-15
claude mcp add naja-scope -- uvx naja-scopeWhat naja-scope 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.
What it helps with
- 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 for the agent
- Load
rtl/uart.svwith topuart_topand show what drivestx_o. - List the instances and ports inside
ex_stage_i. - Trace the combinational fan-in of this signal up to the register boundary.
How to install naja-scope
Platform CLI
claude mcp add naja-scope -- uvx naja-scopeuvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>
Platform CLI
codex mcp add naja-scope -- uvx naja-scopeuvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add naja-scope uvx naja-scopeuvx runs the command named after the package; if the README names another one, use uvx --from naja-scope <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about naja-scope
How do I install naja-scope in Claude Code?
Run claude mcp add naja-scope -- uvx naja-scope. On first launch, uvx fetches naja-scope and najaeda from PyPI.
What does naja-scope do?
It gives an AI agent structured access to hierarchy and connectivity in elaborated SystemVerilog and VHDL designs. Responses can include RTL file-and-line references.
What does naja-scope require?
It requires najaeda version 0.7.35 or newer. Gate-level designs also need a structural Verilog netlist and a Liberty standard-cell library.