Skip to main content
Glama
amritessh

scalpel

by amritessh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

scalpel

Symbol-level codebase retrieval MCP server. Give an agent get_symbol(name) instead of a whole file — it returns just the definition and its usages.

Why

Reading whole files to answer one question about one symbol wastes context. scalpel avoids the read entirely instead of compressing it after the fact.

Related MCP server: codebase-rag

Setup

npm install && npm run build

# index a repo (lang: ts | python | go, default ts)
node dist/build-index.js /path/to/repo /path/to/repo/.scalpel/index.db [lang]

# run the MCP server over stdio
node dist/server.js /path/to/repo /path/to/repo/.scalpel/index.db

Point an MCP client at it (stdio transport, args: <repoPath> <dbPath>).

Does it actually help?

  • Token cost: ~96% fewer tokens than reading whole files, across 4 repos and 3 languages, holds up under formal significance testing.

  • Real dollar cost: same story once billing/caching is accounted for, flat across weak/mid/strong model tiers.

  • Does it fix bugs faster? No net advantage. Tested on 57 real historical bugs — an agent with scalpel's tools and a plain grep/Read agent fix the same bugs, at basically the same speed. This is the paper's headline finding, not a footnote.

Full numbers, every caveat, every negative result: RESULTS.md.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Omniscience

    FreakyLetsFail
    A
    license
    A
    quality
    B
    maintenance
    Enables LLMs to efficiently navigate large codebases by providing surgical access to specific code symbols via semantic search and call-graph queries.
    6
    MIT

  • codebase-rag

    Ar-maan05
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables LLM agents to efficiently understand and navigate a codebase by providing semantic search over symbols and a reference graph, replacing expensive grep/glob calls with structured tools like definition lookup, caller/callee queries, and change-impact analysis.
    2
    MIT

  • codegraph-mcp

    shekharnair96
    A
    license
    Not graded
    quality
    A
    maintenance
    Exposes a codebase's symbol graph and symbol-aware editing tools to AI agents, enabling targeted symbol lookup, impact analysis, and atomic multi-file edits with reduced context tokens.
    24 npm
    MIT

  • scalpel

    amritessh
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables symbol-level codebase retrieval by returning a definition's source span and usage sites, avoiding whole-file reads to reduce token context.
    43 npm
    ISC