Разработчик представил mcp-linter: инструмент для аудита безопасности MCP-серверов

Habr AI · оригинал

Материал подготовлен автоматизированной редакционной системой. Факты можно сверить по указанному первоисточнику.

Специалист разработал утилиту mcp-linter, которая выявляет архитектурные и security-дефекты в серверах Model Context Protocol. Бенчмарк официальных эталонных серверов Anthropic показал наличие критических недочетов в документации и схемах инструментов.

Инструмент позволяет автоматизировать проверку безопасности и качества MCP-серверов, снижая риски инъекций промптов и ошибок интеграции с LLM.

С появлением Model Context Protocol (MCP) от Anthropic разработчики получили стандартизированный способ подключения языковых моделей к внешним сервисам. Однако экосистема столкнулась с дефицитом инструментов для статического анализа и тестирования протокола, что приводит к повторяющимся ошибкам в коде серверов. Для решения этой проблемы был создан mcp-linter — легковесная утилита без сторонних зависимостей, доступная через npm, которая проводит неразрушающий аудит MCP-серверов.

Автор инструмента выделяет четыре ключевых риска при разработке MCP-серверов. Во-первых, загрязнение потока stdout: любые диагностические сообщения, попавшие в этот канал, ломают парсинг JSON-RPC и приводят к падению соединения. Во-вторых, отсутствие аннотаций безопасности (destructiveHint) может привести к тому, что автономный агент выполнит деструктивные действия без подтверждения пользователя. В-третьих, описания инструментов могут содержать скрытые директивы для prompt injection, перехватывающие контекст модели. Наконец, неполные схемы аргументов без описаний полей заставляют LLM гадать формат данных, увеличивая количество ошибок в вызовах.

Архитектура mcp-linter построена на принципах минимализма и безопасности. Инструмент использует только встроенные модули Node.js, что исключает риски атак через цепочку поставок. Аудит проходит в изолированном процессе: линтер выполняет диагностическое рукопожатие, запрашивает списки инструментов и ресурсов, проверяет 34 правила и завершает работу, не вызывая сами инструменты. Результатом становится оценочный балл от 0 до 100 и возможность генерации автоматических исправлений в формате SARIF для интеграции с GitHub Security.

В ходе тестирования на официальных серверах из репозитория modelcontextprotocol были выявлены существенные недочеты. Эталонный тестовый сервер server-everything получил оценку 90 баллов (Grade B), где главной проблемой стало отсутствие описания у одного параметра. Сервер памяти server-memory показал результат 66 баллов (Grade C) из-за отсутствия верхнеуровневых инструкций и четырех параметров без описаний. Наиболее критичным оказался сервер файловой системы server-filesystem, набравший лишь 38 баллов (Grade D). В нем обнаружено 18 параметров без описаний, что затрудняет корректное формирование вызовов моделями.

Разработчик подчеркивает, что отсутствие явных описаний полей, таких как тип пути или кодировка, напрямую влияет на качество работы LLM. Инструмент позволяет не только выявлять эти проблемы, но и автоматически генерировать патчи для исправления схем. Это особенно важно для команд, интегрирующих MCP в CI/CD пайплайны, где автоматический аудит при каждом коммите помогает поддерживать высокий стандарт безопасности.

Проект mcp-linter распространяется под лицензией MIT и уже доступен для использования. В планах разработчика — поддержка удаленных транспортов (SSE и WebSocket), анализ контекстного бюджета серверов и интеграция с LLM для автоматического исправления схем. Инструмент призван стать стандартом де-факто для проверки качества MCP-серверов, обеспечивая прозрачность и надежность взаимодействия между моделями и внешними системами.