Configurare il server MCP WinGet

Questa guida illustra come configurare il server MCP WinGet per l'uso con gli agenti di IA in Visual Studio Code e GitHub Copilot CLI.

Prerequisiti

Prima di usare l'integrazione del server MCP WinGet, assicurarsi di disporre di:

Trovare il percorso eseguibile del server MCP WinGet

Per configurare il server MCP WinGet, è prima necessario individuare il percorso del file eseguibile. Usare una delle opzioni seguenti per trovare il percorso:

Opzione 1: Usare il winget mcp comando

Aprire un prompt dei comandi e immettere il winget mcp comando . Il risultato visualizza il frammento di configurazione JSON che mostra il percorso del WindowsPackageManagerMCPServer.exe file.

winget mcp

Se si verifica l'errore seguente: Comando non riconosciuto: 'mcp'

Verificare che l'applicazione App Installer sia aggiornata sul dispositivo. Questa operazione può essere verificata nell'applicazione Store.

Opzione 2: Usare uno script di PowerShell

Aprire PowerShell e usare lo script seguente per individuare l'eseguibile del server 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"

La posizione tipica è:C:\Users\<username>\AppData\Local\Microsoft\WindowsApps\Microsoft.DesktopAppInstaller_8wekyb3d8bbwe\WindowsPackageManagerMCPServer.exe

Configurare il server MCP in Visual Studio Code

Il modo consigliato per configurare il server MCP WinGet consiste nell'usare un mcp.json file di configurazione. È necessario trovare (potrebbe essere necessario visualizzare i file nascosti) o creare una .vscode cartella nella directory principale del progetto. In questa directory creare un mcp.json file (o aggiornarlo se il file esiste già) con il contenuto seguente:

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

Sostituire <username> con il nome utente effettivo di Windows o usare il percorso eseguibile del server MCP WinGet identificato in precedenza.

Questa configurazione indica ai client MCP di:

  • Usare il file eseguibile del server MCP di Gestione pacchetti Windows (WinGet) come comando
  • Usare la comunicazione di I/O standard tra il client e il server
  • Registrare il server con l'identificatore winget-mcp

Per informazioni dettagliate sulla configurazione e la configurazione mcp in VS Code, vedere Usare server MCP in VS Code.

Configurare il server MCP nell'interfaccia della riga di comando di GitHub Copilot

L'interfaccia della riga di comando di GitHub Copilot offre assistenza basata sull'intelligenza artificiale direttamente nel terminale. Dopo aver registrato il server MCP WinGet con l'interfaccia della riga di comando di Copilot, è possibile cercare e installare pacchetti usando prompt del linguaggio naturale, senza uscire dalla riga di comando.

Prerequisiti per Copilot CLI

  1. Avvia Copilot CLI nel tuo terminale:

    copilot

  2. Al prompt immettere il /mcp add comando slash:

    /mcp add

  3. Compilare i dettagli del server MCP nel modulo interattivo. Usare Tab per spostarsi tra i campi:

    Campo Valore
    Nome winget-mcp
    Tipo stdio
    Command Percorso completo a WindowsPackageManagerMCPServer.exe

  4. Premere CTRL+S per salvare. L'interfaccia della riga di comando di Copilot scrive la configurazione in ~/.copilot/mcp-config.json.

Opzione 2: Modifica mcp-config.json direttamente

Aprire (o creare) ~/.copilot/mcp-config.json e aggiungere la voce seguente, sostituendo <username> con il nome utente di Windows:

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

Note

Se mcp-config.json esiste già e contiene altri server, aggiungere la winget-mcp voce all'interno dell'oggetto esistente mcpServers anziché sostituire il file.

Verificare che il server sia registrato

Dopo aver aggiunto il server, verificare che sia caricato:

  1. Avvia o riavvia l'interfaccia della riga di comando di Copilot:

    copilot

  2. Al prompt immettere:

    /mcp

    L'output elenca tutti i server MCP configurati. Verificare che winget-mcp venga visualizzato e mostri uno stato connesso.

Test manuale della riga di comando

Per avviare manualmente il server MCP WinGet per scopi di test o sviluppo, eseguire il file eseguibile direttamente immettendo il comando seguente in PowerShell:

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

Sostituire <username> con il nome utente di Windows effettivo.

Il server viene avviato e attende i messaggi del protocollo MCP sull'input standard. Il server continua l'esecuzione fino a quando non viene terminato (Ctrl+C) o chiudi il flusso di input.

Contenuti correlati

  • Last updated on