Codebase Brain runs on your own machine — the client starts it, so there is no endpoint to ping. 1 032 installs a week from pypi. Last commit 7 Nov 2026.
Cited, searchable memory of a codebase: hybrid search, git history, impact analysis, doc drift.
What the code does
We read the source, 14 h ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
done = subprocess.run(
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add codebase-brain-mcp -- uvx codebase-brain-mcp{
"mcpServers": {
"codebase-brain-mcp": {
"command": "uvx",
"args": [
"codebase-brain-mcp"
]
}
}
}[mcp_servers.codebase-brain-mcp]
command = "uvx"
args = ["codebase-brain-mcp"]{
"mcpServers": {
"codebase-brain-mcp": {
"command": "uvx",
"args": [
"codebase-brain-mcp"
]
}
}
}{
"servers": {
"codebase-brain-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"codebase-brain-mcp"
]
}
}
}Optional settings from the registry entry, left out of the block above:
GITHUB_TOKEN (Optional. Raises GitHub's rate limit when reading pull request titles and descriptions), CODEBASE_BRAIN_HOME (Where indexes and clones are stored (default ~/.codebase-brain)).
Alternatives to Codebase Brain
same job, measured the same wayPersistent memory for Claude Code — offline, single-file, hybrid search.
MCP server for code archaeology: git blame, file history, contributors, and co-change analysis
A queryable graph of a codebase: impact, callers, tests to run, history. No model, no network.
AST-based semantic code search: 33 tools, 35 languages, call tracing, impact analysis
Query a codebase map (routes, features, flows, impact) built by static analysis.
AST-based semantic code search: 39 tools over 37 languages. Call tracing and impact analysis.
Code intelligence MCP server — impact analysis, semantic search, dependency graphs
Knowledge graph of a PHP codebase by static analysis: calls, routes, buses, layers, impact
Codebase Brain — questions
Answers built from our own checks of this server.