Nastavení serveru WinGet MCP

Tato příručka vás provede konfigurací serveru MCP WinGet pro použití s AI agenty ve Visual Studio Code a GitHub Copilot CLI.

Předpoklady

Před použitím integrace serveru McP WinGet se ujistěte, že máte:

Najděte cestu ke spustitelnému souboru serveru WinGet MCP.

Pokud chcete nastavit server WinGet MCP, musíte nejprve vyhledat cestu ke spustitelnému souboru. K vyhledání cesty použijte jednu z následujících možností:

Možnost 1: Použití winget mcp příkazu

Otevřete příkazový řádek a zadejte winget mcp příkaz. Výsledek zobrazí fragment konfigurace JSON, který zobrazuje cestu k WindowsPackageManagerMCPServer.exe souboru.

winget mcp

Pokud dojde k následující chybě: Nerozpoznaný příkaz: mcp

Ověřte, zda je aplikace App Installer v zařízení aktuální. To je možné ověřit v aplikaci Store.

Možnost 2: Použití skriptu PowerShellu

Otevřete PowerShell a pomocí následujícího skriptu vyhledejte spustitelný soubor serveru 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"

Typické umístění je:C:\Users\<username>\AppData\Local\Microsoft\WindowsApps\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\WindowsPackageManagerMCPServer.exe

Konfigurace serveru MCP v editoru Visual Studio Code

Doporučený způsob konfigurace serveru WinGet MCP je prostřednictvím konfiguračního mcp.json souboru. Potřebujete najít (možná budete muset zobrazit skryté soubory) nebo vytvořit .vscode složku v kořenovém adresáři projektu. V tomto adresáři vytvořte mcp.json soubor (nebo ho aktualizujte, pokud už tento soubor existuje) s následujícím obsahem:

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

Nahraďte <username> vaším skutečným uživatelským jménem systému Windows nebo použijte cestu ke spustitelnému souboru serveru WinGet MCP, kterou jste identifikovali dříve.

Tato konfigurace udává klientům MCP, aby:

  • Jako příkaz použijte spustitelný soubor serveru MCP pro Windows Správce balíčků (WinGet).
  • Použití standardní vstupně-výstupní komunikace mezi klientem a serverem
  • Registrace serveru pomocí identifikátoru winget-mcp

Podrobné informace o konfiguraci a nastavení MCP v nástroji VS Code naleznete v tématu Použití serverů MCP v nástroji VS Code.

Konfigurace serveru MCP v rozhraní příkazového řádku GitHub Copilot

Rozhraní příkazového řádku GitHub Copilot přináší pomoc s AI přímo do terminálu. Po registraci serveru WinGet MCP pomocí rozhraní příkazového řádku Copilot můžete vyhledat a nainstalovat balíčky pomocí výzev přirozeného jazyka , aniž byste opustili příkazový řádek.

Požadavky pro Copilot CLI

  1. Spusťte rozhraní příkazového řádku Copilot v terminálu:

    copilot
    
  2. V příkazové řádce zadejte příkaz /mcp add lomítko:

    /mcp add
    
  3. Vyplňte podrobnosti o serveru MCP v interaktivním formuláři. Mezi poli se můžete pohybovat pomocí tabulátoru :

    Obor Value
    název winget-mcp
    Typ stdio
    Command Úplná cesta k WindowsPackageManagerMCPServer.exe
  4. Stisknutím kombinace kláves Ctrl+S uložte. Copilot CLI zapíše konfiguraci do ~/.copilot/mcp-config.json.

Možnost 2: Upravit mcp-config.json přímo

Otevřete (nebo vytvořte) ~/.copilot/mcp-config.json a přidejte následující položku a nahraďte <username> uživatelské jméno systému Windows:

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

Note

Pokud mcp-config.json již existuje a obsahuje další servery, přidejte winget-mcp položku uvnitř existujícího mcpServers objektu místo nahrazení souboru.

Ověřte, že je server zaregistrovaný.

Po přidání serveru ověřte, že je načten:

  1. Spusťte nebo restartujte CLI Copilotu:

    copilot
    
  2. Na příkazovém řádku zadejte:

    /mcp
    

    Výstup zobrazí seznam všech nakonfigurovaných serverů MCP. Ověřte, že se zobrazí winget-mcp a zobrazí se stav připojení.

Ruční testování příkazového řádku

Pokud chcete server WinGet MCP spustit ručně pro účely testování nebo vývoje, spusťte spustitelný soubor přímo zadáním následujícího příkazu v PowerShellu:

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

Nahraďte <username> skutečným uživatelským jménem systému Windows.

Server se spustí a čeká na zprávy protokolu MCP na standardním vstupu. Server bude dál spuštěný, dokud ho neukončujete (Ctrl+C) nebo nezavřete vstupní datový proud.