Codebase Context Dumper

A Model Context Protocol (MCP) server designed to easily dump your codebase context into Large Language Models (LLMs).

Large context windows in LLMs are powerful, but manually selecting and formatting files from a large codebase is tedious. This tool automates the process by:

- Recursively scanning your project directory.
- Including text files from the specified directory tree that are not excluded by.gitignorerules.
- Automatically skipping binary files.
- Concatenating the content with clear file path markers.
- Supporting chunking to handle codebases larger than the LLM's context window.
- Integrating seamlessly with MCP-compatible clients.

The easiest way to use this tool is vianpx, which runs the latest version without needing a local installation.

Configure your MCP client (e.g., Claude Desktop, VS Code extensions) to use the following command:

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

The MCP client will then be able to invoke thedump_codebase_contexttool provided by this server.

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

- Scans the directory provided inbase_path.
- Respects.gitignorefiles at all levels (including nested ones and.gitby default).
- Detects and skips binary files.
- Reads the content of each valid text file.
- Prepends a header (--- START: relative/path/to/file ---) and appends a footer (--- END: relative/path/to/file ---) to each file's content.
- Concatenates all processed file contents into a single string.

- base_path(string, required): The absolute path to the project directory to scan.
- num_chunks(integer, optional, default: 1): The total number of chunks to divide the output into. Must be >= 1.
- chunk_index(integer, optional, default: 1): The 1-based index of the chunk to return. Requiresnum_chunks > 1andchunk_index <= num_chunks.

Output: Returns the concatenated (and potentially chunked) text content.

Local Installation & Usage (Advanced)

If you prefer to run a local version (e.g., for development):
- Clone the repository:

git clone git@github.com:lex-tools/codebase-context-dumper.git cd codebase-context-dumper

{ "mcpServers": { "codebase-context-dumper": { "command": "/path/to/your/local/codebase-context-dumper/build/index.js" // Adjust path } } }

Contributions are welcome! Please seeCONTRIBUTING.mdfor details on development, debugging, and releasing new versions.

This project is licensed under the Apache License 2.0. See theLICENSEfile for details.

Context7 Private Docs MCP is a paid hosted remote MCP for private, version-pinned documentation context, source citations, stale-doc checks, and usage receipts for coding agents.