Live codebase intelligence for AI agents: conventions, blast radius, import graphs, git insights.
{
"mcpServers": {
"sourcebook": {
"args": [
"-y",
"sourcebook",
"serve",
"--dir",
"/path/to/your/project"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Live codebase intelligence for AI agents: conventions, blast radius, import graphs, git insights.
Is it safe?
No known CVEs for sourcebook.
No authentication — any process on your machine can connect.
License not specified.
Is it maintained?
Last commit 5 days ago.
Will it work with my client?
Transport: stdio, sse, http. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'sourcebook' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Dynamic problem-solving through sequential thought chains
A Model Context Protocol server for searching and analyzing arXiv papers
An open-source AI agent that brings the power of Gemini directly into your terminal.
The official Python SDK for Model Context Protocol servers and clients
MCP Security Weekly
Get CVE alerts and security updates for io.github.maroondlabs/sourcebook and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
AI can read your code. It still doesn't know how your project works.
sourcebook captures the project knowledge your team carries in its head — conventions, patterns, traps, and where things actually go — and turns it into context your coding agent can use.
npx sourcebook init
Tools like Repomix give AI your entire codebase. sourcebook gives it your project knowledge.
AI coding agents spend most of their context window orienting — reading files to build a mental model before doing real work. Most context files (CLAUDE.md, .cursorrules) are generic and go stale fast.
Research shows auto-generated context that restates obvious information actually makes agents worse by 2-3%. The only context that helps is non-discoverable information — the project knowledge agents can't figure out by reading code alone.
sourcebook extracts only what agents keep missing: the conventions, hidden dependencies, fragile areas, and dominant patterns that live in your team's heads — not in the code.
# Generate CLAUDE.md for your project
npx sourcebook init
# Generate for a specific tool
npx sourcebook init --format claude # CLAUDE.md (default)
npx sourcebook init --format cursor # .cursor/rules/sourcebook.mdc + .cursorrules
npx sourcebook init --format copilot # .github/copilot-instructions.md
npx sourcebook init --format all # All of the above
# Re-analyze while preserving your manual edits
npx sourcebook update
# See what changed since last generation (exit code 1 = changes found)
npx sourcebook diff
# Limit output to a token budget (drops low-priority sections first)
npx sourcebook init --budget 1000
| Command | What it does |
|---------|-------------|
| sourcebook init | Analyze codebase and generate context files |
| sourcebook update | Re-analyze while preserving sections you added manually |
| sourcebook diff | Show what would change without writing files (exit code 1 if changes found — useful for CI) |
| sourcebook serve | Start an MCP server exposing live codebase intelligence |
| Flag | Description | Default |
|------|-------------|---------|
| -d, --dir <path> | Target directory | . |
| -f, --format <formats> | Output formats: claude, cursor, copilot, all | claude |
| --budget <tokens> | Max token budget for output | 4000 |
| --dry-run | Preview findings without writing files | — |
| Language | Framework Detection | Convention Detection | Import Graph | Git Analysis | |----------|:------------------:|:-------------------:|:------------:|:------------:| | TypeScript/JavaScript | Next.js, Expo, Vite, React, Express, Tailwind, Supabase | Barrel exports, path aliases, export style, error handling | Full | Full | | Python | Django, FastAPI, Flask, pytest