Codebase Context Dumper automates the extraction and formatting of project code for Large Language Models. It scans directories, respects .gitignore rules, and structures file contents with clear path markers for seamless LLM integration. Key features: - Recursively scans project directories while respecting .gitignore rules at all levels - Automatically detects and skips binary files - Formats output with file path headers and footers for easy LLM parsing - Supports chunking to handle codebases larger than LLM context windows - Integrates with MCP-compatible clients like Claude Desktop and VS Code

[](https://mseep.ai/app/lex-tools-codebase-context-dumper)

codebase-context-dumper MCP Server

[](https://smithery.ai/server/@lex-tools/codebase-context-dumper) [](https://badge.fury.io/js/%40lex-tools%2Fcodebase-context-dumper) [](https://opensource.org/licenses/Apache-2.0)

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

Why Use This?

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:

Usage (Recommended: npx)

The easiest way to use this tool is via npx, 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 the dump_codebase_context tool provided by this server.

Features & Tool Details

Tool: 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.

Functionality:

Input Parameters:

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):

1. Clone the repository:

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

    npm install
    

    npm run build
    

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

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details on development, debugging, and releasing new versions.

License

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