Skip to content
MCP server

RepoLens

Generate architecture docs from a repo: modules, API surface, routes, dependency graph

Runs locallyStatus and history
Install
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/repolens

Add to claude_desktop_config.json

{
  "mcpServers": {
    "repolens": {
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/repolens"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "repolens": {
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/repolens"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers