Repository Inspector MCP Server
Repository Inspector
Это небольшой инструмент для разработчиков на TypeScript, который проверяет изменения в Git-репозитории, запускает дополнительные команды валидации и создает отчет в формате Markdown. Его можно использовать из командной строки или подключать к ИИ-клиентам через MCP.
Ваша задача
Исследуйте репозиторий и улучшите его по своему усмотрению. Стартовый код работает для узкого основного сценария, но при реальном использовании могут проявиться проблемы с корректностью, безопасностью, надежностью, контрактами, выводом, документацией или тестированием.
От вас не требуется успеть все. Нам важно, как вы исследуете, расставляете приоритеты, реализуете, проверяете и объясняете значимый объем работы.
Related MCP server: repository-inspector
Продуктовое решение
Инструментом могут пользоваться как разработчики напрямую, так и ИИ-агенты для написания кода. Решите, каким должен быть основной интерфейс: CLI-first, MCP-first или гибридный. Внесите улучшения в соответствии с вашим решением.
Предпочтительного варианта нет. Опишите:
Основного пользователя и среду выполнения, на которую вы ориентировались.
Границу доверия и разрешенные возможности.
Компромиссы по надежности, обнаруживаемости, задержке/контексту и размеру вывода.
Как интерфейсы, которые вы продолжаете поддерживать, остаются согласованными по поведению.
Какие доказательства могли бы изменить ваше решение.
Время и правила
Максимум 90 минут целенаправленной работы в течение 48 часов с момента получения приглашения.
Свободно используйте ИИ-инструменты для написания кода. Проверяйте их работу и задокументируйте как минимум одно предложение, которое вы исправили или отклонили.
Работайте в собственном репозитории, созданном из этого шаблона.
Делайте коммиты по мере работы и заполните
SUBMISSION.mdв финальном коммите.Завершение не обязательно. Точный объем и проверка важнее большого диффа.
Установка
npm install
npm run typecheck
npm testCLI
npm run inspector -- review --repo ./path/to/repo --format markdown
npm run inspector -- review --repo ./path/to/repo --validate "npm test"Отчет записывается в review-report.md.
MCP
Запустите stdio-сервер командой:
npm run mcp-serverОн предоставляет инструмент review_repository, принимающий repo_path (обязательный), base_ref (необязательный) и validation_commands (необязательный массив shell-команд).
Аргументами MCP можно управлять через содержимое проверяемого репозитория (инъекция промптов), поэтому запуск команд валидации через MCP отключен по умолчанию. Чтобы включить его, оператор сервера должен задать обе переменные окружения — если задана только одна, валидация остается отключенной:
INSPECTOR_ALLOW_VALIDATION=1INSPECTOR_VALIDATION_ALLOWLIST="npm test,npm run typecheck"— разделенный запятыми список точных команд, которым разрешено выполняться; все остальные пропускаются.
Когда валидация отключена или команды нет в списке разрешенных, инструмент по-прежнему возвращает полный отчет только для чтения; пропущенная команда сообщается со статусом status: skipped и причиной, а не молча отбрасывается.
Структура проекта
src/core.ts shared review orchestration
src/cli.ts command-line adapter
src/mcp-server.ts MCP adapter
src/git.ts Git inspection
src/validation.ts validation execution
src/report.ts Markdown report generation
test/ public starter testsПо завершении отправьте через Security → Report a vulnerability в этом репозитории — см. SECURITY.md, чтобы узнать, что именно включить. Не отвечайте по электронной почте; этот канал отправки не отслеживается.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Remote MCP for AI Studio Android release gate MCP, structured receipts, audit logs, and reviewer-rea
Remote MCP for Gemini upgrade evals, prompt regressions, output diffs, and eval receipts.
Git-native policy layer for AI agents: check_action verdicts against rules approved via PR.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to inspect Git repositories for changes across committed, staged, unstaged, and untracked scopes, and run allowlisted validation commands with structured results.-
- FlicenseNot gradedqualityBmaintenanceMCP server that inspects Git repository changes, runs optional validation commands, and generates Markdown reports. Exposes a review_repository tool for AI clients to analyze repositories.-
- FlicenseBqualityDmaintenanceEnables secure, policy-controlled operations on local git repositories through MCP, including bounded reads, context-checked patches, allowlisted tasks, and guarded git operations.10-
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with Git repositories via MCP, supporting status checks, diffs, staging, commits, branch management, and log queries.12MIT