Codebase Context

What it does

Codebase Context is a local-first MCP server that prevents AI agents from wasting tokens exploring your repo. It pre-maps architecture, detects coding patterns from git history, and maintains a persistent team memory of decisions and 'battle scars' that aren't captured in comments.

Tools

• search_codebase: Hybrid search returning ranked results with a preflight decision card for edits.
• get_team_patterns: Analyzes adoption percentages and trends of coding patterns (e.g., DI, state management).
• remember: Records a team convention, decision, gotcha, or failure into persistent memory.
• get_memory: Queries team memory with confidence decay scoring to retrieve historical context.
• get_codebase_metadata: Extracts project structure, frameworks, and dependency information.
• detect_circular_dependencies: Identifies import cycles between files to prevent architectural rot.

Installation

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "codebase-context": {
      "command": "npx",
      "args": ["-y", "codebase-context"]
    }
  }
}

Supported hosts

• Claude Desktop
• Claude Code
• Cursor
• Windsurf
• Codex
• VS Code Copilot
• Zed