modelcontextprotocol / inspector

GitHub

Code

How modelcontextprotocol/inspector is laid out, and where to start for common changes.

Architecture grade

score 99/100

Import cycles

lower is better

373

Files mapped

57 imports between them

96%

Layering

of imports point one way

From the map of which files import which, built when the code was last read in full. It shows what depends on what, not a reading order.

Module map

Shade by

6 modules, 2 links. A link means one module imports another; thicker lines mean more imports. Links come from 373 of 799 source files, so the real counts are higher. Select a module to trace it: blue lines go to what it uses, orange lines come from what uses it.

Where to start reading

Repository root
Repository root
Likely public API
Likely public API
Likely start-up file
Likely start-up file
Suggested starting pointAI
Suggested starting pointAI

Find files for a task

Add a new MCP protocol handler

Define the new protocol message types in the schema validation layer
Implement handler logic in the core client
Add integration test to test server

Add OAuth provider support

Register provider in browser auth providers list
Implement provider-specific OAuth flow
Persist credentials in storage layer

Add a new CLI command

Add error handling specific to CLI output format

Add support for a new MCP server configuration type

Extend the configuration schema
Add config parsing logic

Change the public API

Trace runtime behavior

Add or update tests

Change build or automation

RepoPilot lists up to 500 files, so a file missing here may still exist.

Files marked “likely” are guessed from their names.
Some entry points named in the manifest are build output or are missing from the file list, so their source is not shown.

Code quality and hotspots

Largest source files

Branch points221 per file on average
Code issues0 errors, 53 warnings
Largest file6,517 lines
Hotspot load10 high-risk files

Static checks on the 15 largest source files.

Tests, CI and tooling

CIGitHub Actions6 workflows
Tests689 test filesJest/Vitest · 0.86 test files per source file (file count, not coverage)
Dependency updatesCodeQL

Test folders: clients/cli/__tests__ · clients/cli/__tests__/helpers

Hotspots

core/mcp/inspectorClient.ts100 commits in 180 days · 576 branch points
core/mcp/remote/node/server.ts95 commits in 180 days · 476 branch points
test-servers/src/test-server-fixtures.ts37 commits in 180 days · 207 branch points
clients/tui/src/App.tsx56 commits in 180 days · 422 branch points
clients/web/src/App.tsx100 commits in 180 days · 152 branch points
test-servers/src/composable-test-server.ts38 commits in 180 days · 193 branch points
clients/cli/src/cli.ts84 commits in 180 days · 193 branch points
core/auth/node/oauth-persist-file.ts47 commits in 180 days · 156 branch points

Files that change often and branch heavily, highest first. Branch points count if, loop, case, catch, ternary, && and || in the file.