RepoLens
Generate architecture docs from a repo: modules, API surface, routes, dependency graph
- Pricing
- Free
- Platforms
- CLI, vscode, self-hosted
- Runs
- Locally
- Version
- 1.17.3
- Listing updated
- today
Similar MCP servers
About RepoLens
RepoLens is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.
RepoLens scans a codebase and writes documentation that is regenerated on every push, aimed at engineers and stakeholders at once. The README lists 17 document types, from an executive summary and system overview to a module catalog, API surface, route map, data flows, dependency graph, architecture drift and security hotspots; route and GraphQL pages are skipped when the repository has none.
The MCP server reads one workspace, set by REPOLENS_WORKSPACE, and every tool path must stay inside it. Output can go to Notion, Confluence, GitHub Wiki, Obsidian or Markdown files under .repolens/. It detects 16 languages and frameworks such as Django, FastAPI, Gin, React and NestJS.
There are two modes: a deterministic mode that needs no API keys, and an optional AI-enhanced mode using GitHub Models, OpenAI, Anthropic, Google, Azure or Ollama. A VS Code extension browses the generated architecture, and a GitHub Actions workflow can be created by init.
Install
Run in a terminal
claude mcp add repolens -- npx -y @chappibunny/repolensAdd to claude_desktop_config.json
{
"mcpServers": {
"repolens": {
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"repolens": {
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"repolens": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"repolens": {
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"repolens": {
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
REPOLENS_WORKSPACEAbsolute path of the repository to read. Defaults to the process working directory. Every tool path must stay inside this directory.
What it does
- 17 document types
- Executive summary, module catalog, API surface, route map, dependency graph and more.
- Multiple publishers
- Writes to Notion, Confluence, GitHub Wiki, Obsidian or Markdown.
- Deterministic mode
- Produces docs without API keys or model calls.
- Optional AI enhancement
- Can use GitHub Models, OpenAI, Anthropic, Google, Azure or Ollama.
- Language detection
- Auto-detects 16 languages and common web frameworks.
- Workspace-bound
- Tool paths must stay inside the configured repository.
Good for
- Give a new engineer a map of every module and cycle
- Publish an architecture wiki that updates on each push
- Produce a stakeholder-readable system overview
- Spot architecture drift between releases
- Review change impact on a pull request
Pricing
Free
Deterministic mode free; AI mode uses your own provider keys
RepoLens FAQ
Does it need an API key?
Not in deterministic mode; AI enhancement is optional.
Where can output go?
Notion, Confluence, GitHub Wiki, Obsidian or Markdown files.
Which languages are detected?
Sixteen, including JavaScript, TypeScript, Python, Go, Rust, Java and C#.
How large a repo can it handle?
The README says up to 50k files with performance guardrails.
Is there an editor extension?
Yes, a VS Code extension for browsing the generated docs.
Is RepoLens free?
Yes. RepoLens is free to use.
How do I add RepoLens to Claude Code?
Run this command in your terminal: claude mcp add repolens -- npx -y @chappibunny/repolens
What are the best alternatives to RepoLens?
The closest alternatives to RepoLens are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


