codeviewer-mcp

codeviewer-mcp — это сервер MCP на TypeScript для рабочих процессов проверки кода с поддержкой состояния и AST.

Он работает через STDIO и предназначен для клиентов MCP и сред LLM, которые могут запускать локальные серверы MCP.

Что предоставляет этот сервер

• Инструменты MCP для итеративной регистрации планов и проверки фрагментов кода

• Сеансы проверки и история на базе SQLite

• Индексация AST/локализация контекста для исходных деревьев JS/TS

• Предварительные проверки (диагностика TypeScript + обнаружение шаблонов безопасности)

• Структурированный вывод результатов проверки с вердиктами, категоризированной обратной связью и дополнительными подсказками по исправлению

Related MCP server: lsp-intelligence

Инструменты MCP

1. register_plan

2. review_code_chunk

3. cleanup_expired_sessions

4. cleanup_session

5. list_sessions

6. list_indexing_errors

7. list_prompt_profiles

8. get_prompt_profile

9. health_check

Предварительные требования

Эти требования необходимы для правильной установки и запуска данного MCP.

Инструментарий для нативной сборки по ОС:

• Windows: Visual Studio Build Tools 2022 (разработка классических приложений на C++) + Python 3

• macOS: Xcode Command Line Tools (xcode-select --install)

• Linux (Debian/Ubuntu): build-essential python3 make g++

Если отсутствуют инструменты для нативной сборки, pnpm install может завершиться ошибкой при компиляции better-sqlite3.

Быстрый старт

git clone https://github.com/Master0fFate/codeviewer-mcp.git
cd codeviewer-mcp
pnpm install
pnpm build
pnpm start

Режим разработки:

pnpm dev

Переменные окружения

Пример:

MCP_PROJECT_PATH=/absolute/path/to/repo \
MCP_SESSION_TTL_HOURS=24 \
LOG_LEVEL=info \
node dist/index.js

Пример аутентификации, когда установлен MCP_AUTH_TOKEN:

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "plan_step": 1,
  "target_file": "src/example.ts",
  "code_chunk": "export const ok = true;",
  "modification_type": "MODIFY",
  "auth_token": "your-shared-secret"
}

Рабочий процесс профилей промптов (компартментализированные промпты)

Этот MCP теперь поддерживает компартментализацию промптов на уровне сеанса из папки prompts.

• Добавляйте файлы промптов как *.md в каталог промптов.

• ID профиля — это имя файла без расширения.

  • Пример: prompts/cybersec.md -> prompt_profile: "cybersec"

• Начните сеанс с помощью register_plan и дополнительного prompt_profile.

• Выбранный профиль сохраняется в сеансе и повторно используется для каждого вызова review_code_chunk в этом сеансе.

• Вывод review_code_chunk включает:

  • active_prompt_profile

  • active_prompt_title

  • active_prompt_headings

Используйте вспомогательные инструменты:

• list_prompt_profiles для просмотра доступных профилей.

• get_prompt_profile для чтения полного содержимого промпта для профиля.

Пример полезной нагрузки register_plan со специализированным профилем:

{
  "project_path": "/absolute/path/to/repo",
  "prompt_profile": "cybersec",
  "steps": [
    "Review auth and secrets handling",
    "Check unsafe execution paths"
  ]
}

Руководство по автоматической установке LLM

Этот раздел написан для автономных установщиков LLM и сред MCP.

Канонический запуск сервера

node /absolute/path/to/codeviewer-mcp/dist/index.js

Идемпотентная установка/обновление (bash)

set -euo pipefail
INSTALL_ROOT="${HOME}/mcp-servers"
SERVER_DIR="${INSTALL_ROOT}/codeviewer-mcp"

mkdir -p "${INSTALL_ROOT}"
if [ ! -d "${SERVER_DIR}/.git" ]; then
  git clone https://github.com/Master0fFate/codeviewer-mcp.git "${SERVER_DIR}"
else
  git -C "${SERVER_DIR}" pull --ff-only
fi

cd "${SERVER_DIR}"
pnpm install
pnpm build

Идемпотентная установка/обновление (PowerShell)

$InstallRoot = Join-Path $HOME "mcp-servers"
$ServerDir = Join-Path $InstallRoot "codeviewer-mcp"

New-Item -ItemType Directory -Path $InstallRoot -Force | Out-Null
if (-not (Test-Path (Join-Path $ServerDir ".git"))) {
  git clone https://github.com/Master0fFate/codeviewer-mcp.git $ServerDir
} else {
  git -C $ServerDir pull --ff-only
}

Set-Location $ServerDir
pnpm install
pnpm build

Установка в среду (Claude Code, VS Code Copilot, OpenCode, универсальный MCP)

Используйте одни и те же значения запуска STDIO в каждой среде.

Канонический блок сервера:

{
  "name": "codeviewer-mcp",
  "transport": "stdio",
  "command": "node",
  "args": ["/absolute/path/to/codeviewer-mcp/dist/index.js"],
  "env": {
    "MCP_PROJECT_PATH": "/absolute/path/to/target/repo",
    "MCP_REVIEWER_DB_PATH": "/absolute/path/to/target/repo/.codeviewer-mcp.sqlite",
    "LOG_LEVEL": "info"
  }
}

Claude Code / Claude Desktop

1. Откройте конфигурацию Claude MCP.

2. Добавьте codeviewer-mcp в mcpServers с каноническими значениями command/args/env.

3. Перезапустите Claude.

4. Убедитесь, что инструменты обнаруживаются.

Пример:

{
  "mcpServers": {
    "codeviewer-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/codeviewer-mcp/dist/index.js"],
      "env": {
        "MCP_PROJECT_PATH": "/absolute/path/to/repo"
      }
    }
  }
}

VS Code Copilot (MCP)

1. Откройте управление сервером MCP в VS Code (UI или настройки JSON, в зависимости от версии).

2. Зарегистрируйте локальный сервер MCP STDIO с именем codeviewer-mcp.

3. Установите команду node, укажите аргументы на собранный dist/index.js и установите MCP_PROJECT_PATH.

4. Перезагрузите окно VS Code, если это требуется вашей версией расширения.

5. Подтвердите обнаружение инструментов в списке инструментов MCP чата Copilot.

Если ваша версия поддерживает настройки JSON, сопоставьте канонический блок сервера со схемой настроек MCP.

OpenCode

1. Откройте конфигурацию OpenCode MCP.

2. Добавьте локальный сервер STDIO с именем codeviewer-mcp.

3. Используйте node + собранный dist/index.js.

4. Установите MCP_PROJECT_PATH и дополнительные переменные окружения для БД/логов.

5. Перезапустите OpenCode и убедитесь, что инструменты появились.

Универсальные клиенты MCP

Любой клиент, поддерживающий локальные серверы MCP STDIO, может использовать канонический блок выше. Если имена полей отличаются, сопоставьте те же значения со схемой вашего клиента.

Контрольный список проверки

• [ ] Сервер запускается без ошибок процесса

• [ ] Клиент сообщает об установлении соединения MCP

• [ ] Инструменты видны: register_plan, review_code_chunk, cleanup_expired_sessions, cleanup_session, list_sessions, list_indexing_errors, list_prompt_profiles, get_prompt_profile, health_check

• [ ] register_plan возвращает действительный session_id

• [ ] review_code_chunk возвращает структурированный вывод вердикта

• [ ] health_check сообщает о работоспособности базы данных/сеанса

Разработка и проверка

pnpm test
pnpm build

Примечания по безопасности

• Проверки вложенности путей предотвращают выход за пределы настроенного корневого каталога проекта, включая выходы через символические ссылки.

• Аутентификация является необязательной (MCP_AUTH_TOKEN) и должна быть включена в общих средах.

• Сеансы истекают автоматически на основе MCP_SESSION_TTL_HOURS.

• SQLite настроен в режиме WAL с включенными внешними ключами.

Структура репозитория

• /src/index.ts - Точка входа процесса и транспорт STDIO

• /src/server.ts - Сервер MCP и регистрация инструментов

• /src/schemas.ts - Схемы контрактов инструментов Zod

• /src/state.ts - Хранилище состояния SQLite и жизненный цикл сеанса

• /src/ast.ts - Индексация AST и локализация контекста

• /src/preflight.ts - Статические предварительные проверки

• /src/reviewer.ts - Решение о проверке и формирование вывода

• /src/logger.ts - Структурированное логирование

• /tests - Набор тестов Vitest

Лицензия

GNU v3