# naja-scope MCP server

> Enables AI agents to explore SystemVerilog and VHDL designs by tracing connectivity, hierarchy, and logic cones with file-and-line references.

- Repository: https://github.com/keplertech/naja-scope
- Page: https://hostedmcp.org/servers/keplertech/naja-scope
- Transport: stdio
- Stars: 22
- License: Apache-2.0
- Latest version: 0.1.26

## Install

### Claude Code

```sh
claude mcp add naja-scope -- uvx naja-scope
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "naja-scope": {
      "command": "uvx",
      "args": [
        "naja-scope"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "naja-scope": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "naja-scope"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"naja-scope","type":"stdio","command":"uvx","args":["naja-scope"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "naja-scope": {
      "command": "uvx",
      "args": [
        "naja-scope"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add naja-scope -- uvx naja-scope
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.naja-scope]
command = "uvx"
args = ["naja-scope"]
```

### Gemini CLI

```sh
gemini mcp add -s user naja-scope uvx -- naja-scope
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "naja-scope": {
      "command": "uvx",
      "args": [
        "naja-scope"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `NAJA_SCOPE_ENABLE_PYTHON` | no | no |  |

## FAQ

### What hardware description languages does naja-scope support?

It supports SystemVerilog and VHDL (currently in beta), as well as gate-level Verilog netlists.

### Can I use naja-scope with gate-level netlists?

Yes, you can load post-synthesis structural Verilog netlists along with their Liberty standard-cell library to navigate gates.

### How do I connect naja-scope to ChatGPT?

Run naja-scope as an HTTP server using the `--transport streamable-http` flag and add the resulting URL as a custom connector in ChatGPT settings.

### Does naja-scope help with large designs that exceed context limits?

Yes, it allows agents to ask targeted questions about connectivity and hierarchy instead of reading entire RTL files, which keeps the context small.
