Skip to content

@lex-tools/codebase-context-dumper

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

3
GitHub Stars
Apache-2.0
License
5
Weekly Downloads
create.code.reviewbuild.frameworks.langchainanalyze.document_ai.layout#author:official#environment:local#hosting:local-only

Install @lex-tools/codebase-context-dumper in your MCP client

@lex-tools/codebase-context-dumper is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add @lex-tools/codebase-context-dumper to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; @lex-tools/codebase-context-dumper's tools should appear.
{
  "mcpServers": {
    "-lex-tools-codebase-context-dumper": {
      "command": "npx",
      "args": [
        "-y",
        "@lex-tools/codebase-context-dumper"
      ]
    }
  }
}

Install @lex-tools/codebase-context-dumper in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. @lex-tools/codebase-context-dumper will show up in the assistant's tool list on next launch.

Install @lex-tools/codebase-context-dumper in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). @lex-tools/codebase-context-dumper will show up in the assistant's tool list on next launch.

Install @lex-tools/codebase-context-dumper in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). @lex-tools/codebase-context-dumper will show up in the assistant's tool list on next launch.

Install @lex-tools/codebase-context-dumper in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. @lex-tools/codebase-context-dumper will show up in the assistant's tool list on next launch.

npm package: @lex-tools/codebase-context-dumper

Tools exposed by @lex-tools/codebase-context-dumper

Once installed, @lex-tools/codebase-context-dumper exposes the following MCP tools to your AI assistant. Each tool can be called directly by the assistant whenever its capability is relevant to your prompt.

  • 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.

Transport

@lex-tools/codebase-context-dumper supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdiossestreamable-http

From the @lex-tools/codebase-context-dumper README

# codebase-context-dumper MCP Server [![npm version](https://badge.fury.io/js/%40lex-tools%2Fcodebase-context-dumper.svg)](https://badge.fury.io/js/%40lex-tools%2Fcodebase-context-dumper) [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](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: * Recursively scanning your project directory. * Including text files from the specified directory tree that are not excluded by `.gitignore` rules. * Automatically skipping binary…

Other Model Context Protocol servers in the same space as @lex-tools/codebase-context-dumper. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.