Настройка сервера WinGet MCP

В этом руководстве описывается настройка сервера WinGet MCP для использования с агентами ИИ в Visual Studio Code и GitHub Copilot CLI.

Необходимые условия

Прежде чем использовать интеграцию сервера WinGet MCP, убедитесь, что у вас есть следующее:

Найдите путь к исполняемому файлу сервера WinGet MCP

Чтобы настроить сервер WinGet MCP, сначала необходимо найти путь к исполняемому файлу. Используйте один из следующих параметров, чтобы найти путь:

Вариант 1. Использование winget mcp команды

Откройте командную строку и введите winget mcp команду. В результате отображается фрагмент конфигурации JSON, показывающий путь к файлу WindowsPackageManagerMCPServer.exe .

winget mcp

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

Убедитесь, что приложение установщика приложений обновлено на устройстве. Это можно проверить в приложении Store.

Вариант 2. Использование скрипта PowerShell

Откройте PowerShell и используйте следующий скрипт, чтобы найти исполняемый файл сервера MCP:

# Find the WinGet executable path
$wingetPath = (Get-Command winget).Source
# Get the directory containing WinGet
$wingetDir = Split-Path $wingetPath -Parent
# The MCP server executable is in the same directory
$mcpServerPath = Join-Path $wingetDir "Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\WindowsPackageManagerMCPServer.exe"
Write-Host "WinGet MCP Server path: $mcpServerPath"

Типичное расположение:C:\Users\<username>\AppData\Local\Microsoft\WindowsApps\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\WindowsPackageManagerMCPServer.exe

Настройка сервера MCP в Visual Studio Code

Рекомендуемый способ настройки сервера WinGet MCP — это mcp.json файл конфигурации. Вам нужно найти (может потребоваться отобразить скрытые файлы) или создать .vscode папку в корневом каталоге проекта. В этом каталоге mcp.json создайте файл (или обновите его, если этот файл уже существует) со следующим содержимым:

{
  "servers": {
    "winget-mcp": {
      "type": "stdio",
      "command": "C:\\Users\\<username>\\AppData\\Local\\Microsoft\\WindowsApps\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\WindowsPackageManagerMCPServer.exe"
    }
  },
  "inputs": []
}

Замените <username> фактическим именем пользователя Windows или используйте ранее определенный путь к исполняемому файлу сервера WinGet MCP.

Эта конфигурация сообщает клиентам MCP:

  • Используйте исполняемый файл сервера MCP в диспетчере пакетов Windows (WinGet) в качестве команды.
  • Использование стандартного взаимодействия ввода-вывода между клиентом и сервером
  • Регистрация сервера с идентификатором winget-mcp

Подробные сведения о настройке и настройке MCP в VS Code см. в разделе "Использование серверов MCP в VS Code".

Настройка сервера MCP в интерфейсе командной строки GitHub Copilot

GitHub Copilot CLI обеспечивает помощь на основе искусственного интеллекта непосредственно в терминале. После регистрации сервера WinGet MCP в Copilot CLI можно искать и устанавливать пакеты с помощью запросов естественного языка без выхода из командной строки.

предварительные требования Copilot CLI

  1. Запустите Copilot CLI в терминале:

    copilot
    
  2. В приглашении командной строки введите команду с косой чертой /mcp add.

    /mcp add
    
  3. Заполните сведения о сервере MCP в интерактивной форме. Используйте вкладку для перемещения между полями:

    Поле Value
    Имя winget-mcp
    Тип stdio
    Command Полный путь к WindowsPackageManagerMCPServer.exe
  4. Нажмите клавиши CTRL+S , чтобы сохранить. Copilot CLI записывает конфигурацию в ~/.copilot/mcp-config.json.

Вариант 2. Редактирование mcp-config.json напрямую

Откройте (или создайте) ~/.copilot/mcp-config.json и добавьте следующую запись, заменив <username> имя пользователя Windows:

{
  "mcpServers": {
    "winget-mcp": {
      "type": "stdio",
      "command": "C:\\Users\\<username>\\AppData\\Local\\Microsoft\\WindowsApps\\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\\WindowsPackageManagerMCPServer.exe",
      "args": [],
      "tools": ["*"]
    }
  }
}

Замечание

Если mcp-config.json файл уже существует и содержит другие серверы, добавьте winget-mcp запись внутри существующего mcpServers объекта, а не замените файл.

Проверка регистрации сервера

После добавления сервера убедитесь, что он загружен:

  1. Запуск или перезапуск Copilot CLI:

    copilot
    
  2. В командной строке введите следующее:

    /mcp
    

    В выходных данных перечислены все настроенные серверы MCP. Убедитесь, что winget-mcp отображается и показывает статус подключения.

Тестирование командной строки вручную

Чтобы запустить сервер WinGet MCP вручную для тестирования или разработки, запустите исполняемый файл непосредственно, введя следующую команду в PowerShell:

& "C:\Users\<username>\AppData\Local\Microsoft\WindowsApps\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\WindowsPackageManagerMCPServer.exe"

Замените <username> фактическим именем пользователя Windows.

Сервер запускается и ожидает сообщений протокола MCP на стандартном вводе. Сервер продолжает работать, пока не завершите работу (CTRL+C) или закройте входной поток.