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

Читает исходный код и пишет отчёты; анализ локальный.

Настройка клиентов

cursor
{
    "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.

Риск: medium Лицензия: MIT ★ 5 790

arxiv-mcp-server

Поиск статей arXiv, загрузка полных текстов и графы цитирования.

Риск: high Лицензия: Apache-2.0 ★ 3 271

PaperBanana

Генерация научных диаграмм и графиков по тексту.

Риск: medium Лицензия: MIT ★ 2 467

ToolUniverse

Более 2700 научных инструментов для ИИ-исследователей.

Риск: medium Лицензия: Apache-2.0 ★ 1 786

Источники