SKILLEMALL.ai

BF building-python-mcp-servers

Создавайте надежные серверы Python MCP (Model Context Protocol) с помощью FastMCP — проектирование инструментов, контракты ошибок, блокирующая работа, безопасная для цикла событий, обертка для подпроцессов/CLI, тестирование без глобального состояния, осведомленность о внедрении подсказок. Используйте при написании сервера MCP, предоставлении инструмента или CLI клиенту LLM, отладке регистрации/упаковки инструментов или тестировании инструментов MCP.

машинный переводПоказать оригиналСкрыть оригинал«Builds robust Python MCP (Model Context Protocol) servers with FastMCP…»

Builds robust Python MCP (Model Context Protocol) servers with FastMCP — tool design, error contracts, event-loop-safe blocking work, subprocess/CLI wrapping, single-file vs packaged distribution, global-state-free testing, and prompt-injection awareness. Use when writing an MCP server, exposing a tool or CLI to an LLM client, debugging tool registration/packaging, or testing MCP tools.

kajisho5/ffmpeg-skill Agent Skills автор: kajisho5 MIT 1 файл тело ≈ 3 113 токенов Открыть источникgithub.com↗ проанализирован 5 дн назад

Создавайте надежные серверы Python MCP (Model Context Protocol) с помощью FastMCP — проектирование инструментов, контракты ошибок, блокирующая работа…

Как процесс F 31/100 · Процесс не описан — Скилл ссылается на файлы, которых нет в архиве: scripts/_contract.py

ГенераторИИ и агентыРазработкатип и темы размечены автоматически по тексту скилла
JSON
Технический рейтинг
B
91/100
безопасность, качество, тесты
Безопасность 60%
100
Качество 40%
78
Прогон на моделях
не было
Процессный рейтинг
F
31/100
Процесс не описан
Скилл ссылается на файлы, которых нет в архиве: scripts/_contract.py
Инструменты и файлы вес 18
0
Результат и критерий готовности вес 14
0
Входы и предусловия вес 11
0
три самых слабых из десяти параметров · все десять

Как улучшить

  1. В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
Для прогона на моделях — необязательно
  • Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
  • spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.

Находки guard · 0

✓ Критических и высоких находок нет

Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.

По спецификации Agent Skills

  • предупреждение missing-ref ссылка на отсутствующий файл: scripts/_contract.py

Процессный рейтинг: все десять параметров 31/100

Не запустится. Скилл ссылается на файлы, которых нет в архиве: scripts/_contract.py
  • 0Инструменты и файлы. Не хватает 1 файла(ов): scripts/_contract.py
  • 0Результат и критерий готовности. Не сказано, что считать результатом
  • 0Входы и предусловия. Не сказано, что нужно иметь на входе
  • 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
  • 20Когда включается. Не сказано, при каком запросе скилл включается
  • 30Повторный запуск. Изменяющих операций: 2, без проверки текущего состояния
  • 40Согласованность. Имя во frontmatter (building-python-mcp-servers) не совпадает с папкой (mcp-server-design)
  • 50Ошибки и развилки. Развилок: 0, есть раздел про ошибки
  • 85Шаги. Шагов: 12, расплывчатых формулировок: 1
  • 100Стоимость исполнения. Тело инструкции 3113 токенов
  • low Разделов верхнего уровня: 11. Похоже на несколько доменов в одном скилле

Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.

Сигналы качества

  • +5В description нет примеров фраз, по которым скилл должен срабатывать
  • +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
  • +3Формат ответа не описан: модель каждый раз решает сама
  • +1Лицензия не указана
  • +2Инструкции на одном языке
  • +3Длина description 389 символов: достаточно сигнала, не съедает бюджет
  • +4Структура: 12 заголовков
  • +3Пошаговые инструкции: 12 пунктов
  • +4Есть примеры (8 блоков кода)

База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 78.