Archprint — MCP-сервер для TypeScript: правила архитектуры с доказательствами
Читает TypeScript-проект, находит правила архитектуры, которым код уже следует, и показывает доказательства для каждого. Генерирует линт-правила для ESLint и dependency-cruiser.
claude mcp add archprint -- npx -y archprintЧто делает Archprint
Archprint сканирует TypeScript-репозиторий и выводит правила, которые код фактически соблюдает. Для каждого правила показывает, сколько файлов ему следуют, какие нарушают и насколько вывод уверен. Например, правило «роуты не обращаются к базе напрямую» подтверждается списком файлов-нарушителей.
Команды init, wire и eject превращают найденные правила в проверки ESLint и dependency-cruiser. wire добавляет одну строку в конфиг ESLint, после чего нарушение ловится при следующем прогоне линта. eject откатывает проект точно к исходному состоянию.
MCP-сервер только сообщает правила — принуждение остаётся в линтере. Агент вроде Claude Code или Cursor может запросить правила проекта с доказательствами перед тем, как писать код. На демо-проекте из 70 файлов запрос правил через Archprint стоил $0.037 против $0.083 без него, а время ответа сократилось с 17 до 10 секунд — потому что агент читает готовые правила, а не весь репозиторий.
Для работы нужен Node.js с npx. Сервер запускается локально и работает с Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed и Gemini CLI.
Какие задачи решает
- найти негласные правила архитектуры в TypeScript-проекте
- показать доказательства для каждого правила: сколько файлов следует, какие нарушают
- сгенерировать ESLint-правила из паттернов кодовой базы
- поймать нарушение правил в пул-реквесте, а не на ревью через недели
- дать AI-агенту правила проекта с доказательствами до написания кода
Примеры запросов агенту
- Спроси у Archprint, какие правила архитектуры соблюдает этот репозиторий
- Покажи правила, которые уже принуждаются, и те, что ждут ревью
- Проверь моё изменение на нарушение правил через Archprint
Как установить Archprint
Командой платформы
claude mcp add archprint -- npx -y archprintКомандой платформы
codex mcp add archprint -- npx -y archprintФайл настроек
{
"mcpServers": {
"archprint": {
"command": "npx",
"args": [
"-y",
"archprint"
]
}
}
}Файл настроек
{
"servers": {
"archprint": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"archprint"
]
}
}
}Командой платформы
gemini mcp add archprint npx -y archprintПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Archprint
Как установить Archprint в Claude Code?
Выполните claude mcp add archprint -- npx -y archprint. После этого агент сможет вызывать инструменты Archprint через MCP.
Что делает Archprint?
Сканирует TypeScript-проект и находит правила архитектуры, которым код уже следует. Для каждого правила показывает доказательства: сколько файлов следуют, какие нарушают. Найденные правила можно превратить в проверки ESLint и dependency-cruiser.
Чем Archprint отличается от CLAUDE.md с инструкциями?
CLAUDE.md — это руководство, а линт-правила — принуждение. Archprint генерирует принуждение из паттернов, которые кодовая база уже демонстрирует, вместо того чтобы писать правила вручную.
