Skip to main content
Glama
Sign In
scalpel

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Omniscience

      FreakyLetsFail
      A
      license
      A
      quality
      D
      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
      D
      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.
      4
      MIT

    • codegraph-mcp

      shekharnair96
      A
      license
      Not graded
      quality
      B
      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.
      9 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