mcp-tldr
MCP server that exposes https://github.com/parcadei/llm-tldr code analysis tools to Claude Code (or any MCP client).
Prerequisites
- Python 3.11+
tldrCLI installed and in your PATH (install instructions)
Setup
git clone https://github.com/YOUR_USER/mcp-tldr.git
cd mcp-tldr
python3 -m venv .venv
.venv/bin/pip install -e .Add to Claude Code
Add this to your ~/.claude.json under mcpServers:
{
"mcpServers": {
"tldr": {
"type": "stdio",
"command": "/absolute/path/to/mcp-tldr/.venv/bin/python",
"args": ["server.py"],
"cwd": "/absolute/path/to/mcp-tldr"
}
}
}Replace /absolute/path/to/mcp-tldr with the actual path where you cloned the repo.
Alternatively, if tldr is not in your PATH, set the TLDR_BIN environment variable:
{
"tldr": {
"type": "stdio",
"command": "/absolute/path/to/mcp-tldr/.venv/bin/python",
"args": ["server.py"],
"cwd": "/absolute/path/to/mcp-tldr",
"env": {
"TLDR_BIN": "/path/to/tldr"
}
}
}Available Tools
| Tool | Description | |------|-------------| | tldr_tree | File tree of a project | | tldr_structure | Code structure (classes, functions, imports) | | tldr_context | LLM-ready context for a function/class | | tldr_search | Pattern search across files | | tldr_impact | Find all callers of a function | | tldr_calls | Cross-file call graph | | tldr_semantic | Natural language code search | | tldr_arch | Detect architectural layers | | tldr_warm | Pre-build cache for faster queries | | tldr_extract | Full file analysis (classes, functions, methods) | | tldr_cfg | Control flow graph for a function | | tldr_dfg | Data flow graph for a function | | tldr_slice | Program slice (what affects line X) | | tldr_dead | Find unreachable/dead code | | tldr_imports | Parse imports from a file | | tldr_importers | Find all files importing a module | | tldr_change_impact | Find tests affected by changes | | tldr_diagnostics | Type-check and lint diagnostics |
Usage
After setup, restart Claude Code. The tools will be available automatically. Example prompts:
- "Use tldr_tree to show the structure of this project"
- "Use tldr_context to explain the
handleAuthfunction" - "Use tldr_impact to see what calls
processPayment"
