Bloch
Ranked, budgeted codebase maps and shared memory for coding agents across repos
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 1.0.3
- Listing updated
- today
Similar MCP servers
About Bloch
Bloch is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The README describes bloch as a command-line tool that walks a repository, extracts definitions, ranks them by cross-file references with recency weighting, and emits a size-limited map so an agent can read the map instead of the whole tree. Its output opens with a handoff section covering git session state, cached test and lint status, and the contents of a .ai/memory/ directory, so a different model can resume work where the previous session stopped.
The project also ships an MCP server, started with a serve command, that indexes several repositories and exposes tools for searching and proposing memory entries, tracking roadmap state, recording outcomes and searching lessons. The README says files remain the canonical store and the server is an index and write gate. Content lanes are enforced in server code, and the stated transport is stdio JSON-RPC.
It suits developers running coding agents across one or more repositories who want compact context and a trackable v1 roadmap. The README notes that the Bloch sphere name is a metaphor for dimensional reduction and that the tool performs no quantum computation.
Install
Run in a terminal
claude mcp add bloch -- npx -y blochsAdd to claude_desktop_config.json
{
"mcpServers": {
"bloch": {
"command": "npx",
"args": [
"-y",
"blochs"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bloch": {
"command": "npx",
"args": [
"-y",
"blochs"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bloch": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"blochs"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bloch": {
"command": "npx",
"args": [
"-y",
"blochs"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bloch": {
"command": "npx",
"args": [
"-y",
"blochs"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Ranked codebase maps
- Ranks definitions by qualified cross-file references with recency weighting and fits them into a character budget.
- Session handoff section
- Leads output with git state, memory files and cached test status so a new agent session can resume quickly.
- Optional SCIP indexes
- Reads SCIP indexes for compiler-accurate definitions and falls back to tree-sitter when unavailable or stale.
- Persistent agent memory
- Writes machine-readable and summary memory files under .ai/memory/ and shows diffs against the cached map.
- Gated roadmap tasks
- Marks roadmap tasks done only after their verify commands all pass, and records each attempt in an append-only log.
- Multi-repo MCP server
- Serves memory, tracker, idea and lesson tools over stdio across several repository roots with lane-based access control.
Good for
- Giving a coding agent a compact map of a large repository instead of the full file tree
- Handing off an in-progress coding session between different AI models
- Tracking a repository's progress toward a v1 roadmap with verified task completion
- Sharing lessons and memory entries across several repositories through one MCP server
Pricing
Open source
Apache-2.0 licensed open source, installed via cargo.
Prices change. Check qompass.ai before you buy.
Bloch FAQ
How is the package installed?
The README says to run cargo install blochs. The package name is blochs because bloch was already taken, and the installed binary is bloch.
What license is it released under?
The README states it is licensed under the Apache License, Version 2.0.
Does it use quantum computing?
No. The README says bloch is a classical tool and the Bloch sphere is only a metaphor for dimensional reduction.
Which languages get full parsing?
The README lists Rust with full tree-sitter extraction and qualified-reference ranking, plus tree-sitter support for Python, Lua, TypeScript, Kotlin, Bash, Nix and Markdown, with regex fallback for Ruby and config formats.
Is Bloch free?
Yes. Bloch is open source, so you can use and self-host it for free.
How do I add Bloch to Claude Code?
Run this command in your terminal: claude mcp add bloch -- npx -y blochs
What are the best alternatives to Bloch?
The closest alternatives to Bloch are codeagent-memory, Plumb, Cork, Kodelyth ECC and Limpet.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.