Codebase MCP

What it does

Codebase MCP transforms any MCP-compatible LLM (like Claude Desktop) into a full-featured coding assistant. It provides a local-first bridge to your codebase, enabling semantic search and intelligent editing without requiring a dedicated paid coding assistant subscription.

Tools

• session_tool: Manages isolated development branches and auto-commits.
• memory_tool: Stores and retrieves persistent architectural and logic knowledge.
• git_tool: Handles standard Git operations like diffs and logs.
• write_tool: Creates new files with auto-formatting and quality scoring.
• edit_file: AI-assisted code editing powered by Gemini.
• search_tool: Performs semantic, fuzzy, text, or symbol-based code searches.
• read_code_tool: Smart code reading with symbol-level granularity.
• project_context_tool: Provides high-level project analysis and dependency overviews.
• list_directory_tool: Explores project structure with tree views.
• code_analysis_tool: Runs syntax and linting checks.
• list_file_symbols_tool: Extracts functions, classes, and interfaces from files.
• read_symbol_from_database: Fast indexed retrieval of code symbols.
• project_structure_tool: Visualizes project structure with statistics.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "codebase-manager": {
      "command": "/path/to/your/.venv/bin/python",
      "args": [
        "/path/to/codebase-mcp/mcp_server.py"
      ]
    }
  }
}

Supported hosts

• Claude Desktop
• any MCP-compatible LLM