Log inSubmit server
Scopewalker MCP logo

Scopewalker MCP

Local stdio MCP tools for measuring code size, complexity, documentation, smells, prop drilling, and dead code.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Scopewalker MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "scopewalker-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "scopewalker-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 9 tools correctly (Today).

Overview

scopewalker-mcp analyzes local codebases through nine read-only MCP tools for size, structure, complexity, documentation, smells, prop drilling, and dead code. It combines tree-sitter for syntax analysis, tokei for line counts, and fast-glob for file discovery, without making network calls. Use it when an agent needs concrete code-quality checks before a review or refactor. The server runs over stdio and supports common MCP clients configured to launch an npm command.

Use cases

  • Check a repository against file and function size thresholds
  • Locate high-complexity functions before refactoring
  • Find undocumented exports and missing code comments
  • Trace prop drilling across functions and files
  • Review likely dead code and unresolved code-smell markers

Key features

  • Nine read-only codebase analysis tools
  • AST analysis for eight programming-language families
  • Local stdio operation with no network calls
  • Complexity, size, and documentation metrics
  • Prop-drilling and dead-code detection
  • Configurable path and result limits

Tools9

What Scopewalker MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 46d

What it can do

From the 9 tools this server returned when we ran it; 9 declare their own safety hints.

Read-only tools · 9
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age106 days
Maintainers1

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · scopewalker-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads1.1kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed9Callable tools this server registers over MCP.

How Scopewalker MCP works

What scopewalker-mcp does

scopewalker-mcp gives AI agents a read-only view of codebase quality and structure. Its tools report file and function sizes, nesting and parameter complexity, imports, cognitive and cyclomatic complexity, documentation coverage, code inventory, comment-based markers, prop drilling, and potentially unused code.

The server is intended for local repository analysis rather than editing files or applying fixes. It can identify oversized files and functions, undocumented symbols, high-complexity hotspots, parameters forwarded through multiple layers, and symbols that appear to be unreferenced. Findings can support code reviews, refactoring decisions, and standards checks.

AST-based analysis supports TypeScript, JavaScript, Python, Go, Rust, Java, C, C++, and Ruby. Line counting uses tokei and can report on every language that tokei recognizes.

How it works

The server communicates over stdio and performs analysis on paths available to the MCP client. Tree-sitter parses source files, tokei calculates line totals, and fast-glob discovers files. The tools are read-only and make no network calls, so source analysis remains on the local machine.

Directory scans stay within allowed roots and do not follow symbolic links. When SCOPEWALKER_ALLOWED_ROOTS is set, its comma-separated absolute paths take precedence. Otherwise, the server uses workspace roots shared by the client, falling back to the working directory and system temporary directory when no workspace roots are shared.

AST-based tools skip files larger than 1 MB. Request limits include a maximum of 10,000 files, a depth of 64, and a result limit of 5,000; tools generally return 20 items unless a different limit is requested. Code-smell comments are redacted by default and can be returned explicitly.

Setup and configuration

Node.js 22 or newer and the tokei command-line tool are required. Install tokei with Homebrew or Cargo, then launch the published package through npx -y scopewalker-mcp. A global npm installation is also available. Developers building from source can clone the repository, install dependencies, build it, and point an MCP client at dist/index.js.

The package includes configurations for Claude Code, Claude Desktop, Cursor, VS Code with Agent Mode, Windsurf, Gemini CLI, and OpenAI Codex CLI. Claude Desktop can use the packaged .mcpb release; the other examples launch the npm package as a stdio command. After configuration, an agent can select the appropriate tool from a natural-language request.

Tools and capabilities

  • get_line_counts reports total, code, blank, and comment lines, with sorting, extension filters, and project totals.
  • get_functions lists functions and methods, with optional per-function line details and minimum-size filtering.
  • get_complexity_metrics measures nesting, parameters including JSX props, imports, cognitive complexity, and cyclomatic complexity, and highlights hotspots.
  • check_thresholds finds files and functions above configurable size limits, with defaults of 300 lines per file and 100 per function.
  • get_code_inventory catalogs classes, methods, functions, interfaces or types, enums, and constants, including export status.
  • get_documentation_coverage calculates coverage and lists undocumented functions, classes, and methods.
  • get_code_smells detects common markers in parsed comments and TypeScript double casts such as as unknown as.
  • get_prop_drilling traces parameters forwarded across functions and files and assigns risk levels.
  • find_dead_code separates likely dead symbols from exported symbols that require human judgment.

These tools are useful for requests such as checking repository thresholds, locating complex functions, finding undocumented exports, reviewing TODO markers, or identifying functions with too many parameters.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Scopewalker MCP

scopewalker-mcp is an MCP server that connects AI agents to local codebases over stdio and provides nine read-only analysis tools. It measures line counts, functions, complexity, thresholds, inventories, documentation coverage, code smells, prop drilling, and dead code without sending source files over the network.

Install Node.js 22+, install the tokei command, and configure your MCP client to run `npx -y scopewalker-mcp`. You can also install the npm package globally or build from source and launch its `dist/index.js` file.

scopewalker-mcp parses TypeScript, JavaScript, Python, Go, Rust, Java, C, C++, and Ruby for AST-based tools. Its line-count tool uses tokei, so it can report on any language recognized by tokei.

Yes, scopewalker-mcp works with Cursor through a stdio entry in the global `~/.cursor/mcp.json` file or a project-level `.cursor/mcp.json` file. The configuration launches `npx -y scopewalker-mcp`.

No, scopewalker-mcp performs analysis locally over stdio and makes no network calls. Its scans are limited to allowed roots, workspace roots shared by the client, or the configured fallback directories.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewScopewalker MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/scopewalker-mcp?style=directory)](https://allmcps.com/mcp/scopewalker-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/scopewalker-mcp"><img src="https://allmcps.com/api/badge/scopewalker-mcp?style=directory" alt="Scopewalker MCP on AllMCPs" /></a>