Использование сервера WinGet MCP

Когда сервер WinGet MCP настроен, его можно использовать с агентами ИИ в Visual Studio Code и GitHub Copilot CLI для обнаружения и установки пакетов.

Использование средств WinGet MCP в Visual Studio Code

Чтобы начать использовать MCP-сервер Диспетчера пакетов Windows (WinGet) в Visual Studio Code:

  1. Откройте окно чата расширения GitHub Copilot и выберите режим агента , чтобы включить интеграцию инструментов MCP.
  2. Доступ к средствам WinGet MCP, выбрав значок инструмента в окне чата GitHub Copilot и найдите MCP Server: winget-mcp в списке доступных инструментов.
  3. Убедитесь, что средства сервера WinGet MCP доступны, и рядом с записью стоит галочка.
  4. Начните задавать вопросы или запрашивать помощь с задачами управления пакетами. Агент искусственного интеллекта автоматически использует средства WinGet MCP, если это необходимо, чтобы обеспечить точную справку с учетом контекста.

Использование WinGet MCP в интерфейсе командной строки GitHub Copilot

После регистрации сервера Copilot CLI автоматически вызывает средства WinGet MCP, когда запрос включает управление пакетами. После каждого запроса поиска или установки Copilot запрашивает утверждение перед выполнением любой команды. Примеры запросов и подсказки см. в разделе "Примеры запросов".

Доступные команды

Сервер WinGet MCP в настоящее время поддерживает следующие команды:

поиск

Выполняет поиск репозитория WinGet для пакетов, соответствующих указанным критериям. Это средство помогает обнаруживать доступное программное обеспечение и их сведения.

Агент ИИ передает намерение естественного языка (например, найти средство чтения PDF) серверу WinGet MCP, который преобразует его в соответствующий winget search запрос. Не указывайте именованные параметры напрямую — агент интерпретирует запрос и создает поиск.

Установить

Инициирует установку указанного пакета из репозитория WinGet. Агент всегда запрашивает утверждение перед выполнением любой команды установки.

Агент ИИ определяет идентификатор пакета, версию и любые параметры установки из командной строки естественного языка и создает соответствующую winget install команду. В командной строке можно указать версию или дополнительные параметры (например, "установить Node.js 20 LTS"), а агент сопоставляет их с соответствующими аргументами командной строки.

Примеры подсказок

Следующие запросы хорошо работают с GitHub Copilot (VS Code) и GitHub Copilot CLI при настройке сервера WinGet MCP:

Goal Пример запроса
Поиск пакета "Search WinGet for a PDF reader"
Установка по имени "Install the latest version of Git"
Установка определенной версии "Install Node.js 20 LTS from WinGet"
Поиск пакетов для задачи "What WinGet packages are available for container development?"
Поиск пакетов для разработки Python "What packages are available for Python development?"
Установка общего инструмента "Help me install Visual Studio Code"
Поиск пакетов для конкретной платформы "Find packages for Docker on Windows"

Советы по эффективному инициированию

Чтобы помочь Copilot надежно вызывать средства WinGet MCP, используйте язык, который четко указывает намерение управления пакетами. Если Copilot не использует средства WinGet MCP автоматически, добавьте явные ключевые слова, такие как "using WinGet", "from WinGet" или "search WinGet" в запрос.

При использовании VS Code также убедитесь, что режим агента по-прежнему включен и что winget-mcp проверяется на панели инструментов. При использовании Copilot CLI используйте /mcp для подтверждения подключения сервера.

Troubleshooting

Проблемы с подключением

Если возникают проблемы с подключением между VS Code и сервером WinGet MCP:

  1. mcp.json Проверьте синтаксис файла конфигурации.
  2. Проверьте, что путь к WindowsPackageManagerMCPServer.exe правильный.
  3. Убедитесь, что исполняемый файл имеет соответствующие разрешения для выполнения.
  4. Просмотрите панель вывода VS Code для получения подробных сообщений об ошибках.
  5. Попробуйте перезапустить интеграцию MCP в VS Code.

Ограниченный или отсутствующий ответ от ИИ-агента

Если агент ИИ не использует средства WinGet MCP:

  • Используйте определенные запросы, которые четко указывают, что требуется информация об управлении пакетами.
  • Попробуйте использовать такие фразы, как "Поиск пакетов" или "Установка с помощью WinGet".
  • Убедитесь, что режим агента включен в Чате Copilot.
  • Проверьте, отображаются ли средства WinGet MCP в списке инструментов.

Проблемы с установкой пакета

Если установка пакета завершается сбоем или ведет себя неожиданно:

  • Просмотрите команду установки или параметры, предлагаемые агентом ИИ.
  • Ознакомьтесь с руководством по устранению неполадок WinGet для распространенных проблем.
  • Убедитесь, что у вас есть соответствующие разрешения на установку программного обеспечения.
  • Убедитесь, что источник пакета доступен.

Limitations

Important

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

К текущим ограничениям интеграции сервера WinGet MCP относятся:

  • Поведение агента: агенты ИИ могут не использовать сервер WinGet MCP для каждого запроса, хотя конкретное предложение может поощрять его использование.
  • Доступность инструмента: в настоящее время интеграция поддерживает только find команды и install команды. Будущие выпуски могут добавить поддержку дополнительных команд.