LabscoMCP early access ↗
mixelpixxMCP SERVER

CodeSeeker Search & Replace

Search a codebase the way ugrep does — boolean, fuzzy, inside archives, by code structure — and replace across it with a dry run and backups by default.

by mixelpixx ↗Local Filesystem AccessCommunity

LABSCO SUMMARY

Dry run and backups are the defaults, not options.

A replace tool an agent can call is only safe if the careless call is the harmless one, and here it is: dryRun is on and backup is on until you turn them off, and the file cap stops a bad pattern from touching a thousand files. On the search side, boolean and fuzzy matching are the two that a plain grep wrapper cannot do — finding urgent TODOs that are not marked done, or an identifier whose spelling you got wrong, in one call.

What it is

An MCP server built on ugrep that gives an assistant both halves of a refactor: finding things and changing them. Search covers plain patterns, boolean expressions, approximate matching, compressed archives and language-aware code structures; replacement runs in preview mode unless you say otherwise and writes timestamped backups when it does.

What you get

  • Pattern search with file-type include and exclude lists, context lines and a result cap that defaults to 100 — basic_search
  • Boolean queries with AND, OR, NOT and parentheses, so error AND (critical OR fatal) is one search rather than three — boolean_search
  • Approximate matching that tolerates 1 to 9 character errors, defaulting to 2, for the identifier you cannot quite remember — fuzzy_search
  • Search inside compressed files and nested archives without extracting them — archive_search
  • Code structures found by kind — function, class, method, import or variable — in JavaScript, TypeScript, Python, Java or C++ — code_structure_search
  • Find and replace with capture groups, dry run on by default, backups on by default, and a file cap that defaults to 50 — search_and_replace
  • Several replacements applied in one pass, each with its own pattern and description — bulk_replace
  • Language-aware renaming of a function, class, variable or import across the codebase — code_refactor
  • The supported file types listed and search statistics reported — list_file_types, get_search_stats
  • Ugrep's interactive terminal mode launched, for the cases where you want to drive the search yourself — interactive_search

Requirements

No account and no key. ugrep must be installed and on your PATH — ugrep --version should report 7.4 or higher — via apt-get, Homebrew, Chocolatey or from source. Node.js 18 or higher. The npm package name is codeseeker-mcp (0.1.0); build from a clone with npm install and npm run build, then point your client at the built index.js. Interactive mode needs a real terminal and cannot run through MCP, so treat it as a command it hands you rather than a search it performs.

Setup effort

One command — npx -y github:mixelpixx/CodeSeeker-MCP

See installation options