# RepoLens

> RepoLens is a free MCP server for developer tools. Generate architecture docs from a repo: modules, API surface, routes, dependency graph. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, vscode, self-hosted
- **Repository:** https://github.com/chapibunny/repolens
- **MCP Registry name:** io.github.CHAPIBUNNY/repolens
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add repolens -- npx -y @chappibunny/repolens
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "repolens": {
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/repolens"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "repolens": {
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/repolens"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "repolens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/repolens"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "repolens": {
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/repolens"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "repolens": {
      "command": "npx",
      "args": [
        "-y",
        "@chappibunny/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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/repolens
