pyscn
pyscn — MCP-сервер сообщества (автор — ludo-technologies). Анализ Python-кода: сложность, мёртвый код, клоны, связность и оценка состояния. Ставится через uvx или через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- ludo-technologies
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- go
Уровень риска: high
Читает исходный код и пишет отчёты; анализ локальный.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"pyscn-mcp\": {\n \"command\": \"uvx\",\n \"args\": [\"pyscn-mcp\"],\n \"env\": {\n \"PYSCN_CONFIG\": \"/path/to/.pyscn.toml\"\n }\n }\n }\n}",
"lang": "json",
"notes": "Дословно из README (Cursor / Claude Desktop)",
"verified": "docs"
}
Что умеет
pyscn — анализатор качества кода на Python, созданный для эпохи ИИ-программирования. Если код пишут Cursor, Claude или ChatGPT, pyscn помогает сохранить его поддерживаемым за счёт структурного анализа. Одна команда оценивает весь проект по шкале 0–100 с оценкой от A до F и создаёт HTML-отчёт, который показывает, что исправлять в первую очередь. Инструмент написан на Go с tree-sitter, по данным авторов — быстрее 100 000 строк в секунду.
Что проверяет:
- Мёртвый код — недостижимый код, который можно безопасно удалить.
- Дубликаты — скопированный и структурно похожий код (клоны типов 1–4).
- Сложность — функции и классы, которые трудно читать и тестировать (цикломатическая и когнитивная сложность).
- Горячие точки — качество по файлам и сложность по каталогам, чтобы расставить приоритеты рефакторинга.
- Архитектура — циклические импорты, нарушения правил слоёв (пресеты clean, layered, hexagonal, MVC) и автоматически найденные сообщества модулей.
- Дизайн классов — классы, которые делают слишком много или слишком от многого зависят (связность CBO, когезия LCOM4).
MCP-сервер pyscn-mcp даёт агентам те же виды анализа в виде MCP-инструментов. Для JavaScript, TypeScript, Go, Rust и C++ есть родственный инструмент polyscan.
Кому подойдёт
- Python-разработчикам, которые пишут код с ИИ: агент сам находит дубли и сложные места и помогает их упростить.
- Тимлидам: оценка здоровья проекта и обзор архитектуры.
- Тем, кто настраивает CI: быстрая проверка
pyscn checkс порогами сложности и запретом циклических зависимостей.
Похожие серверы — в категории разработка.
Установка
Без установки: uvx pyscn@latest analyze . или pipx run pyscn analyze .. Постоянно: pipx install pyscn или uv tool install pyscn. На Mac с Intel пакеты PyPI не ставятся — используйте brew install pyscn или go install. Настройки хранятся в .pyscn.toml (создаётся командой pyscn init) или в секции [tool.pyscn] файла pyproject.toml. Для MCP-сервера путь к настройкам задаёт переменная PYSCN_CONFIG.
Подключение к клиентам
Команда и конфиг приведены дословно из README. Общий порядок — в инструкции как подключить MCP.
claude mcp add pyscn-mcp uvx -- pyscn-mcpЭтот JSON добавляется в настройки MCP в Cursor или в Claude Desktop — README указывает для него путь ~/.config/claude-desktop/config.json. В Claude Code можно поставить плагин, который настраивает MCP-сервер и навыки сразу: claude plugin marketplace add ludo-technologies/pyscn, затем claude plugin install pyscn-mcp@pyscn-marketplace. Навыки отдельно ставятся командой uvx add-skills ludo-technologies/pyscn.
Проверка
Откройте Python-проект и попросите агента проанализировать качество кода в каталоге — вы получите оценку и список проблем.
Примеры задач
Проанализируй качество кода в каталоге app/ и скажи, что исправить в первую очередь.Найди дублирующийся код и помоги его отрефакторить.Риски
pyscn читает исходный код проекта и записывает отчёты — по умолчанию в каталог из настроек (например, reports). Анализ выполняется локально. Рекомендации по рефакторингу применяет уже агент, поэтому просматривайте изменения перед коммитом. Удаление «мёртвого кода» тоже стоит проверять: динамические вызовы статический анализ может не увидеть. Лицензия — MIT.
Частые вопросы
Нужно ли ставить pyscn заранее?
Нет. MCP-сервер запускается через uvx pyscn-mcp, а разовый анализ — через uvx pyscn@latest analyze ..
Можно ли использовать в CI?
Да. pyscn check . выдаёт быстрый результат «прошёл/не прошёл» с настраиваемыми порогами, например --max-complexity 15 или --max-cycles 0.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Zotero MCP
Поиск, чтение, аннотации и пополнение библиотеки Zotero.
arxiv-mcp-server
Поиск статей arXiv, загрузка полных текстов и графы цитирования.
PaperBanana
Генерация научных диаграмм и графиков по тексту.
ToolUniverse
Более 2700 научных инструментов для ИИ-исследователей.