suede-mcp-qa

Suede MCP QA — это скилл для проверки MCP-сервера и его документации перед выпуском. Его предметная область узкая: не абстрактный контроль качества любого API, а живой MCP-сервер Suede Skills MCP, его каталог и согласованность описанной поверхности с фактическим поведением. В исходнике прямо указано, что проверку нужно выполнять против запущенного сервера, а не только против спецификации или набора документов. Перед началом читается mcp/catalog.json, затем проверяется, что заявленный блок mcp совпадает с тем, что сервер возвращает через tools/list, resources/list и prompts/list. Если количество или состав поверхностей расходятся, источником истины для исправления считается массив tools, resources и prompts в mcp/suede-skills-mcp.mjs, после чего каталог проверяется повторно. Рабочий сценарий охватывает полный MCP-жизненный цикл в одном процессе: initialize, уведомление notifications/initialized, ping, tools/list, tools/call, resources/list, resources/read, prompts/list и prompts/get. Это важно для протокола: новый процесс создаёт новую сессию, поэтому одиночный вызов после отдельного initialize не подтверждает готовность той же сессии. Скилл также проверяет переговоры версии протокола, включая ответ на неподдерживаемую версию клиента, вызовы до инициализации, повторную инициализацию, неизвестные методы и имена, ограниченные входы и аргументы, неверный JSON, неизвестные ресурсы и промпты, а также превышение транспортного лимита. Для здорового stderr ожидается пустой вывод, а stdout должен содержать только JSON Lines без логов и stack trace. Для каждого из семи заявленных инструментов проверяются закрытая inputSchema, outputSchema и аннотации. В опубликованном контракте ожидаются readOnlyHint=true, destructiveHint=false, idempotentHint=true и openWorldHint=false. Успешный вызов должен вернуть structuredContent, полезный человекочитаемый текстовый блок и тот же структурированный результат в виде сериализованного JSON-текста для старых клиентов. В текущем SKILL.md перечислены семь инструментов: list_suede_skills, get_suede_skill, suede_install_options, suede_copy_seo_audit, suede_visibility_grade, suede_code_grade и suede_qa_checklist; также перечислены шесть ресурсов и пять промптов. Эти списки нужны как контрольные значения, но при дрейфе сначала повторно читается фактическая реализация. Отдельная часть проверки касается каталога и установки. Нужно разобрать catalog.json, убедиться, что каждая указанная папка существует и содержит читаемый SKILL.md, а затем проверить, что install-команда ведёт к публичной GitHub-установке. Команду установки нельзя считать рабочей по одному тексту: её следует запустить из временного каталога. README, документация, каталог и live-сервер должны использовать согласованные названия и описания. Такой подход помогает обнаружить рассинхронизацию между транспортом, каталогом, документацией и SEO-копией до публикации. Скилл носит рекомендательный, а не блокирующий характер: результаты проверок, оценки и вердикты ship, ship-with-caveats или hold прикладываются к отчёту, но сами по себе не отменяют явно запрошенное действие. Исключение сделано для чрезвычайно опасных случаев, связанных с потерей данных, безопасностью, утечкой credentials, правами, платежами или необратимым публичным ущербом. Скилл не заменяет проверку конкретного сервера, не гарантирует отсутствие дефектов вне перечисленных поверхностей и не разрешает объявлять проверку успешной по одному парсингу каталога. Его полезный результат — воспроизводимая транзакция запросов и ответов, перечень фактических ошибок, проверка install-пути и честный ship-вердикт с оговорками.