ctxlint — MCP-сервер для Claude Code: что делает и как установить
Сверяет файлы инструкций для ИИ-агентов с реальным кодом проекта. Находит битые пути, устаревшие команды сборки и утечки секретов.
claude mcp add ctxlint -- npx -y @yawlabs/ctxlintЧто делает ctxlint
Инструкции вроде CLAUDE.md, .cursorrules или AGENTS.md быстро теряют актуальность при рефакторинге. Разработчик переносит файлы или меняет тестовый фреймворк. Агент продолжает опираться на старые правила и ошибается. Сервер ctxlint сопоставляет содержимое инструкций с кодовой базой и файлами настроек вроде package.json или Makefile.
Пакет поставляется без сторонних рантайм-зависимостей и даёт 7 инструментов через протокол MCP. Сервер выявляет противоречия между разными руководствами, считает расход токенов в контекстном окне и подсвечивает секреты в тексте правил. Для сломанных путей утилита находит актуальные файлы через историю Git.
Для репозиториев с GitHub Actions инструмент дополнительно проверит документацию шагов деплоя и переменных окружения.
Какие задачи решает
- найти несуществующие пути к файлам в
CLAUDE.mdи.cursorrules - обнаружить расхождения команд сборки с
package.jsonиMakefile - убрать лишние токены и дублирующиеся правила из контекста агента
- предотвратить утечку секретов и токенов авторизации через файлы инструкций
- выявить противоречия между несколькими файлами конфигурации агентов
Примеры запросов агенту
- Проверь файл CLAUDE.md с помощью ctxlint и найди устаревшие пути
- Запусти аудит контекстных файлов проекта и покажи расход токенов
- Сверь команды тестирования в AGENTS.md с реальными скриптами сборки
Как установить ctxlint
Командой платформы
claude mcp add ctxlint -- npx -y @yawlabs/ctxlintКомандой платформы
codex mcp add ctxlint -- npx -y @yawlabs/ctxlintФайл настроек
{
"mcpServers": {
"ctxlint": {
"command": "npx",
"args": [
"-y",
"@yawlabs/ctxlint"
]
}
}
}Файл настроек
{
"servers": {
"ctxlint": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@yawlabs/ctxlint"
]
}
}
}Командой платформы
gemini mcp add ctxlint npx -y @yawlabs/ctxlintПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ctxlint
Как установить ctxlint в Claude Code?
Выполните в терминале команду claude mcp add ctxlint -- npx -y @yawlabs/ctxlint.
Что проверяет ctxlint в проекте?
Сервер сканирует файлы инструкций вроде AGENTS.md или .mcp.json и сверяет их с кодом. Он находит битые ссылки, конфликты правил, утечки ключей и команды, которых нет в проекте.
Как работает исправление битых путей?
Утилита анализирует историю переименований в Git и нечёткое соответствие названий, предлагая правильный путь или обновляя его с флагом --fix.
