RepoLens — MCP-сервер для Claude Code: архитектурные доки из репозитория
Сканирует репозиторий и собирает архитектурную документацию: обзор, модули, API, маршруты, граф зависимостей. Пригодится, когда доки отстали от кода.
claude mcp add --env REPOLENS_WORKSPACE=<REPOLENS_WORKSPACE> --transport stdio repolens -- npx -y @chappibunny/repolensЧто делает RepoLens
RepoLens читает исходники и генерирует набор документов — от технических до понятных без погружения в код. Среди них обзор архитектуры, каталог модулей, поверхность API, карта маршрутов, граф зависимостей и отчёт об изменениях. Всего 17 типов документов, разложенных по трём аудиториям.
Работает в двух режимах. Детерминированный ничего не стоит и не требует ключей. AI-режим подключается опционально через GitHub Models, OpenAI, Anthropic, Google, Azure или Ollama. Публикация идёт в Notion, Confluence, GitHub Wiki, Obsidian или Markdown; для Obsidian нужен obsidian.vault в .repolens.yml, API-ключ ему не требуется. Для Notion и Confluence токены кладут в .env.
Нужен Node.js 18+. Установка пакета — npm install @chappibunny/repolens, дальше npx @chappibunny/repolens init создаёт конфиг и workflow для GitHub Actions. Если обновляетесь с v0.3.0 или раньше, прогоните npx @chappibunny/repolens migrate, иначе старые файлы workflow останутся как есть.
Какие задачи решает
- собрать обзор архитектуры проекта без ручного описания
- получить каталог модулей и поверхность API из кода
- построить граф зависимостей репозитория
- показать нетехническим коллегам читаемую схему системы
- обновлять документацию на каждом пуше
Примеры запросов агенту
- Просканируй репозиторий и собери обзор архитектуры
- Покажи каталог модулей и поверхность API этого проекта
- Опубликуй сгенерированные документы в Markdown
Как установить RepoLens
Командой платформы
claude mcp add --env REPOLENS_WORKSPACE=<REPOLENS_WORKSPACE> --transport stdio repolens -- npx -y @chappibunny/repolensВместо <…> подставьте свои значения
Командой платформы
codex mcp add repolens --env REPOLENS_WORKSPACE=<REPOLENS_WORKSPACE> -- npx -y @chappibunny/repolensВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"repolens": {
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
],
"env": {
"REPOLENS_WORKSPACE": "<REPOLENS_WORKSPACE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"repolens": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chappibunny/repolens"
],
"env": {
"REPOLENS_WORKSPACE": "<REPOLENS_WORKSPACE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e REPOLENS_WORKSPACE=<REPOLENS_WORKSPACE> repolens npx -y @chappibunny/repolensВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о RepoLens
Как установить RepoLens в Claude Code?
Добавьте сервер командой claude mcp add repolens -- npx -y @chappibunny/repolens. Если нужен путь к рабочей папке, используйте вариант с переменной окружения: claude mcp add --env REPOLENS_WORKSPACE=<REPOLENS_WORKSPACE> --transport stdio repolens -- npx -y @chappibunny/repolens.
Что делает RepoLens?
Сканирует репозиторий и генерирует архитектурную документацию: обзор системы, модули, API, маршруты, граф зависимостей, отчёт об изменениях. Публикует результат в Notion, Confluence, GitHub Wiki, Obsidian или Markdown.
Нужны ли API-ключи для работы RepoLens?
Нет, детерминированный режим работает без ключей. AI-режим опционален и подключается через GitHub Models, OpenAI, Anthropic, Google, Azure или Ollama. Токены нужны только для публикации в Notion и Confluence.
