Name: Codebase Context Dumper
Author: lex-tools

LABSCO SUMMARY

The exclusions come from the repository's own .gitignore, so the dump matches what the project already treats as source.

Binary files are skipped and ignored paths stay out without a second exclusion list to keep in step with the first. Chunking is the caller's decision rather than the tool's: num_chunks and chunk_index return the repository in pieces you ask for in order, and because each piece keeps its per-file path headers, a chunk still reads as itself rather than as a fragment.

What it is

A single tool that walks a directory and returns its text files as one concatenated document, each file wrapped in headers and footers carrying its path.

What you get

dump_codebase_context, which recursively reads the text files under a base_path, respecting .gitignore rules and skipping binary files.
File path headers and footers around each file's content, so the boundaries survive the concatenation.
Chunking through num_chunks and chunk_index, for a codebase too large to come back in one response.

Requirements

Nothing to supply — no account, no key. A directory the server can read, and a .gitignore in it if you want the exclusions the project already maintains to apply.

Setup effort

One command — npx -y @lex-tools/codebase-context-dumper

See installation options

USE CASES

01

Handing a whole repository to a model in one pass

The directory is walked recursively with .gitignore applied and binaries left out, and a repository too big for one response comes back as numbered chunks that each keep their per-file path headers.

dump_codebase_context

1 tool

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`dump_codebase_context`

Recursively reads text files from a specified directory, respecting .gitignore rules and skipping binary files. Concatenates content with file path headers/footers. Supports chunking the output for large codebases.

BEFORE YOU INSTALL

What to know first

Tools you get

1 tool when we connected.

Requires

npx on PATH

CONTEXT COST

Light Standing cost

Rated by the size of the one tool definition that rides along on every turn

INSTALLATION

Connect your client

Add the block to your client, or run the command directly.

Server setup

Configuration file

JSON

{
  "mcpServers": {
    "codebase-context-dumper": {
      "command": "npx",
      "args": [
        "-y",
        "@lex-tools/codebase-context-dumper"
      ]
    }
  }
}

npx

TERMINAL

npx -y @lex-tools/codebase-context-dumper

Codebase Context Dumper