Имя пакета и команда запуска: что сверить до настройки MCP

В инструкции указан пакет, а в конфигурации — другая команда. Это не обязательно опечатка: имя Python-пакета и имя программы, которую он предоставляет, могут различаться. Перед настройкой MCP проверьте их связь, а не подбирайте похожие названия.

Разделите три имени

Имя распространяемого пакета нужно установщику. Имя команды нужно средству запуска. Имя Python-модуля относится к коду внутри пакета. Они могут совпадать, но такое совпадение нельзя принимать за правило.

В метаданных Python-проекта таблица [project.scripts] связывает имя консольной команды со ссылкой на объект Python. Это определяет спецификация pyproject.toml. Ни название репозитория, ни заголовок карточки каталога сами по себе такую связь не устанавливают.

Разберите небольшой пример

Ниже — выдуманный фрагмент метаданных, а не готовый MCP-сервер или полный проект для сборки. Не устанавливайте одноимённый пакет по этому примеру.

[project]
name = "demo-mcp-package"
version = "1.2.3"

[project.scripts]
demo-mcp = "demo_mcp.server:main"

Здесь распространяемый пакет назван demo-mcp-package, консольная команда — demo-mcp, а её точка входа — объект main в модуле demo_mcp.server. Фрагмент объясняет соответствие имён; существование модуля и работу MCP он не проверяет.

Явно укажите пакет средству запуска

В uv команда uvx — короткая форма uv tool run. Когда имя команды отличается от имени пакета, параметр --from указывает пакет. В нём можно задать конкретную версию. Такую запись описывает официальное руководство uv. Для учебных имён она выглядела бы так:

uvx --from "demo-mcp-package==1.2.3" demo-mcp

Это образец разбора аргументов, не предложение выполнить установку. В реальной инструкции заменять нужно только то, что подтверждает издатель проекта: имя пакета, версию, команду и необходимые аргументы. Не переносите имя функции Python в позицию консольной команды.

Фиксация версии помогает указать, какую версию вы намерены использовать. Она не подтверждает происхождение пакета, исправность программы или безопасность её действий. Изолированное окружение зависимостей uv также не является проверкой содержимого кода или ограничением всех его прав в операционной системе.

Сверьте происхождение и выбранную версию

• Откройте документацию по ссылке издателя, а не только результат поиска по похожему имени.
• Сопоставьте пакет и команду с инструкцией той версии, которую собираетесь запускать.
• Если издатель публикует исходники, проверьте соответствующий выпуск и объявленные точки входа; файл из другой ветки может описывать другую версию.
• Если связь пакета и команды не установлена, сохраните вопрос издателю вместо пробных установок нескольких похожих пакетов.

Такая сверка выявляет несоответствие инструкции и команды. Она не заменяет проверку прав доступа, поведения кода и условий самого источника данных.

Отделите ошибку команды от подключения

Сообщение о ненайденной команде ещё не говорит, что источник данных недоступен. Сначала выясните, доступен ли сам запускатель в среде клиента, какой пакет указан и какое исполняемое имя он должен предоставить. При ошибке сохраните команду без секретов, выбранную версию и сообщение запуска.

После этой сверки переходите к быстрому старту MCP. Там уже нужно выбрать способ подключения и клиент. Установленный пакет, запущенный процесс и инструмент, доступный агенту, — разные этапы проверки; совпадение имён не закрывает их автоматически.