Un server MCP (Model Context Protocol) per l’esecuzione di script PowerShell, che supporta sia la modalit\u00e0 HTTP che STDIO.<\/p>\n\n\n\n
run-script<\/code><\/a><\/li><\/ul><\/li>- Configurazione<\/a><\/li>
- Sicurezza<\/a><\/li>
- Registrazione (Logging)<\/a><\/li>
- Integrazione con assistenti AI<\/a>
- Gemini CLI<\/a><\/li>
- Altri client MCP<\/a><\/li><\/ul><\/li>
- Risoluzione dei problemi<\/a>
- Problemi comuni<\/a><\/li>
- Diagnostica<\/a><\/li><\/ul><\/li>
- Sviluppo ed estensione<\/a><\/li>
- Licenza<\/a><\/li>
- Supporto<\/a><\/li>
- Versioni<\/a><\/li><\/ol><\/div>
Descrizione<\/h2>\n\n\n\n
Il Server MCP PowerShell consente agli assistenti AI di eseguire comandi e script PowerShell tramite il protocollo standardizzato MCP. Il server supporta due modalit\u00e0 operative:<\/p>\n\n\n\n
\n- Modalit\u00e0 STDIO<\/strong>: Per l’integrazione con
gemini-cli<\/code> e altri client MCP locali.<\/li>\n\n\n\n- Modalit\u00e0 HTTP<\/strong>: Per applicazioni web e integrazione di rete tramite API REST.<\/li>\n<\/ul>\n\n\n\n
Quale modalit\u00e0 scegliere: HTTP o STDIO?<\/h2>\n\n\n\n
La scelta tra mcp-powershell-http.ps1<\/code> e mcp-powershell-stdio.ps1<\/code> dipende da come e da dove<\/strong> l’applicazione client interagir\u00e0 con il server.<\/p>\n\n\n\n\nmcp-powershell-http.ps1<\/code> (modalit\u00e0 HTTP)<\/strong> funziona come un cameriere in un ristorante<\/strong>. Prende gli ordini (richieste HTTP) da qualsiasi client sulla rete, li passa alla “cucina” (PowerShell) e restituisce il risultato pronto (risposta HTTP).<\/li>\n\n\n\nmcp-powershell-stdio.ps1<\/code> (modalit\u00e0 STDIO)<\/strong> funziona come un assistente personale in cucina<\/strong>. Riceve i compiti direttamente (tramite l’input standard stdin<\/code>) da un processo di gestione (ad es. gemini-cli<\/code>) che lo ha avviato, e restituisce immediatamente il risultato (tramite l’output standard stdout<\/code>).<\/li>\n<\/ul>\n\n\n\nQuando usare la modalit\u00e0 HTTP<\/h3>\n\n\n\n
Dovresti scegliere HTTP se \u00e8 richiesta un’interazione di rete<\/strong>.<\/p>\n\n\n\n\n- Gestione remota:<\/strong> L’applicazione client si trova su un altro computer.<\/li>\n\n\n\n
- Integrazione web:<\/strong> \u00c8 necessario chiamare script PowerShell da un’applicazione web, un pannello di amministrazione o tramite richieste AJAX.<\/li>\n\n\n\n
- Architettura a microservizi:<\/strong> Altri servizi nella tua rete devono interagire con PowerShell.<\/li>\n\n\n\n
- Test semplici:<\/strong> Vuoi utilizzare strumenti come
curl<\/code>, Postman o Invoke-RestMethod<\/code> per inviare comandi.<\/li>\n<\/ul>\n\n\n\n\nIn parole semplici:<\/strong> scegli HTTP se c’\u00e8 una rete<\/strong> tra il client e il server.<\/p>\n<\/blockquote>\n\n\n\nQuando usare la modalit\u00e0 STDIO<\/h3>\n\n\n\n
Questa modalit\u00e0 \u00e8 ideale per l’integrazione locale e sicura<\/strong>.<\/p>\n\n\n\n\n- Scenario principale \u2014 Gemini CLI:<\/strong> Lo strumento
gemini-cli<\/code> avvia mcp-powershell-stdio.ps1<\/code> come processo figlio e comunica con esso direttamente tramite i flussi di input\/output standard.<\/li>\n\n\n\n- Integrazione con altre applicazioni locali:<\/strong> Il tuo programma in Python, Node.js o un altro linguaggio pu\u00f2 avviare e gestire il server senza aprire porte di rete.<\/li>\n\n\n\n
- Sicurezza migliorata:<\/strong> Poich\u00e9 non vengono aperte porte di rete, questo metodo \u00e8 pi\u00f9 sicuro per impostazione predefinita.<\/li>\n<\/ul>\n\n\n\n
\nIn parole semplici:<\/strong> scegli STDIO se il client e il server si trovano sulla stessa macchina<\/strong> e il client avvia il server stesso.<\/p>\n<\/blockquote>\n\n\n\nTabella di confronto<\/h3>\n\n\n\nCaratteristica<\/th> Modalit\u00e0 HTTP (mcp-powershell-http.ps1<\/code>)<\/th>Modalit\u00e0 STDIO (mcp-powershell-stdio.ps1<\/code>)<\/th><\/tr><\/thead>Scenario principale<\/strong><\/td>Interazione di rete, API web<\/td> Integrazione locale con strumenti CLI<\/td><\/tr> Tipo di comunicazione<\/strong><\/td>Client-server su rete (TCP\/IP)<\/td> Comunicazione tra processi (IPC)<\/td><\/tr> Posizione<\/strong><\/td>Client e server possono trovarsi su macchine diverse<\/td> Client e server devono trovarsi<\/strong> sulla stessa macchina<\/td><\/tr>Sicurezza<\/strong><\/td>Richiede attenzione (accesso alla porta, firewall)<\/td> Pi\u00f9 sicuro per impostazione predefinita (nessuna porta aperta)<\/td><\/tr> Client tipici<\/strong><\/td>curl<\/code>, Postman, applicazioni web, script remoti<\/td>gemini-cli<\/code>, applicazioni wrapper locali<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nCaratteristiche<\/h2>\n\n\n\n\n- \u2705 Supporto per il protocollo MCP versione 2024-11-05<\/li>\n\n\n\n
- \u2705 Due modalit\u00e0 operative: STDIO e HTTP<\/li>\n\n\n\n
- \u2705 Isolamento dell’esecuzione degli script in processi PowerShell separati<\/li>\n\n\n\n
- \u2705 Timeout di esecuzione configurabili<\/li>\n\n\n\n
- \u2705 Registrazione dettagliata di tutte le operazioni<\/li>\n\n\n\n
- \u2705 Gestione degli errori e degli avvisi di PowerShell<\/li>\n\n\n\n
- \u2705 Supporto per i parametri degli script<\/li>\n\n\n\n
- \u2705 Directory di lavoro configurabile<\/li>\n\n\n\n
- \u2705 Launcher automatici per semplificare l’avvio<\/li>\n<\/ul>\n\n\n\n
Requisiti di sistema<\/h2>\n\n\n\n\n- PowerShell 7.0 o successivo<\/li>\n\n\n\n
- Windows 10\/11 o Windows Server 2019+<\/li>\n\n\n\n
- .NET 6.0 o successivo<\/li>\n<\/ul>\n\n\n\n
Struttura del progetto<\/h2>\n\n\n\nmcp-powershell-server\/\n\u251c\u2500\u2500 src\/\n\u2502 \u251c\u2500\u2500 clients\/ # Applicazioni client\n\u2502 \u2502 \u251c\u2500\u2500 node\/ # Client Node.js\n\u2502 \u2502 \u251c\u2500\u2500 powershell\/ # Client PowerShell\n\u2502 \u2502 \u2514\u2500\u2500 python\/ # Client Python\n\u2502 \u2514\u2500\u2500 servers\/ # Componenti del server\n\u2502 \u251c\u2500\u2500 mcp-powershell-stdio.ps1 # Versione STDIO del server\n\u2502 \u251c\u2500\u2500 mcp-powershell-http.ps1 # Versione HTTP del server\n\u2502 \u251c\u2500\u2500 test-mcp.ps1 # Server di test\n\u2502 \u2514\u2500\u2500 config.json # File di configurazione\n\u251c\u2500\u2500 docs\/ # Documentazione\n\u251c\u2500\u2500 README.md # Questo file\n\u2514\u2500\u2500 how-to-use.md # Guida dettagliata all'uso<\/code><\/pre>\n\n\n\nAvvio rapido<\/h2>\n\n\n\nModalit\u00e0 STDIO (per gemini-cli)<\/h3>\n\n\n\n\n- Avviare il server:<\/strong>
powershell .\\src\\servers\\mcp-powershell-stdio.ps1<\/code><\/li>\n\n\n\n- Testare:<\/strong>
powershell .\\src\\servers\\test-mcp.ps1<\/code><\/li>\n<\/ol>\n\n\n\nModalit\u00e0 HTTP<\/h3>\n\n\n\n\n- Avvio base:<\/strong>
powershell .\\src\\servers\\mcp-powershell-http.ps1<\/code><\/li>\n\n\n\n- Con parametri personalizzati:<\/strong>
powershell .\\src\\servers\\mcp-powershell-http.ps1 -Port 9090 -ServerHost "0.0.0.0"<\/code><\/li>\n\n\n\n- Con un file di configurazione:<\/strong>
powershell .\\src\\servers\\mcp-powershell-http.ps1 -ConfigFile ".\\src\\servers\\config.json"<\/code><\/li>\n<\/ol>\n\n\n\nStrumenti MCP disponibili<\/h2>\n\n\n\nrun-script<\/code><\/h3>\n\n\n\nEsegue uno script PowerShell con i parametri specificati.<\/p>\n\n\n\n
Parametri:<\/strong><\/p>\n\n\n\n\nscript<\/code> (obbligatorio) – Codice PowerShell da eseguire<\/li>\n\n\n\nparameters<\/code> (opzionale) – Tabella hash dei parametri<\/li>\n\n\n\nworkingDirectory<\/code> (opzionale) – Directory di lavoro<\/li>\n\n\n\ntimeoutSeconds<\/code> (opzionale) – Timeout di esecuzione (1-3600 sec)<\/li>\n<\/ul>\n\n\n\nEsempio di utilizzo tramite MCP:<\/strong><\/p>\n\n\n\n{\n "name": "run-script",\n "arguments": {\n "script": "Get-Process | Select-Object -First 5 | Format-Table",\n "workingDirectory": "C:\\\\",\n "timeoutSeconds": 30\n }\n}<\/code><\/pre>\n\n\n\nConfigurazione<\/h2>\n\n\n\n
Il server supporta la configurazione tramite il file config.json<\/code>:<\/p>\n\n\n\n{\n "Port": 8090,\n "Host": "localhost",\n "MaxConcurrentRequests": 10,\n "TimeoutSeconds": 300,\n "AllowedPaths": [\n "C:\\\\Scripts\\\\",\n "C:\\\\Tools\\\\"\n ],\n "Security": {\n "EnableScriptValidation": true,\n "BlockDangerousCommands": true,\n "RestrictedCommands": [\n "Remove-Item",\n "Format-Volume",\n "Stop-Computer",\n "Restart-Computer"\n ]\n }\n}<\/code><\/pre>\n\n\n\nSicurezza<\/h2>\n\n\n\n\n- L’esecuzione degli script avviene in processi PowerShell isolati<\/li>\n\n\n\n
- Supporto per un elenco di comandi vietati<\/li>\n\n\n\n
- Limite del tempo di esecuzione<\/li>\n\n\n\n
- Registrazione di tutti i comandi eseguiti<\/li>\n\n\n\n
- Possibilit\u00e0 di limitare i percorsi accessibili<\/li>\n<\/ul>\n\n\n\n
Registrazione (Logging)<\/h2>\n\n\n\n\n- Modalit\u00e0 STDIO<\/strong>: I log vengono scritti in
%TEMP%\\mcp-powershell-server.log<\/code><\/li>\n\n\n\n- Modalit\u00e0 HTTP<\/strong>: I log vengono visualizzati nella console con evidenziazione a colori<\/li>\n<\/ul>\n\n\n\n
Livelli di log: DEBUG, INFO, WARNING, ERROR<\/p>\n\n\n\n
Integrazione con assistenti AI<\/h2>\n\n\n\nGemini CLI<\/h3>\n\n\n\ngemini --mcp-config "path\/to\/mcp_servers.json" -m gemini-2.5-pro -p "Mostra i primi 5 processi nel sistema"<\/code><\/pre>\n\n\n\nAltri client MCP<\/h3>\n\n\n\n
Il server \u00e8 compatibile con tutti i client che supportano il protocollo MCP 2024-11-05.<\/p>\n\n\n\n
Risoluzione dei problemi<\/h2>\n\n\n\nProblemi comuni<\/h3>\n\n\n\n\n- Porta occupata<\/strong>: Cambia la porta nella configurazione o arresta il processo che utilizza la porta.<\/li>\n\n\n\n
- Diritti di accesso<\/strong>: L’esecuzione su porte privilegiate (<1024) richiede i diritti di amministratore.<\/li>\n\n\n\n
- Codifica<\/strong>: Assicurati che PowerShell sia configurato su UTF-8.<\/li>\n\n\n\n
- Versione di PowerShell<\/strong>: \u00c8 richiesto PowerShell 7+.<\/li>\n<\/ol>\n\n\n\n
Diagnostica<\/h3>\n\n\n\n
Controlla i log del server per diagnosticare i problemi:<\/p>\n\n\n\n
Get-Content "$env:TEMP\\mcp-powershell-server.log" -Tail 20<\/code><\/pre>\n\n\n\nSviluppo ed estensione<\/h2>\n\n\n\n
Il server \u00e8 facilmente estendibile con nuovi strumenti MCP. Consulta how-to-use.md<\/code> per istruzioni dettagliate sullo sviluppo.<\/p>\n\n\n\nLicenza<\/h2>\n\n\n\n
Questo progetto \u00e8 distribuito sotto la licenza MIT. Vedi il file LICENSE per i dettagli.<\/p>\n\n\n\n
Supporto<\/h2>\n\n\n\n\n- Crea una “Issue” nel repository GitHub.<\/li>\n\n\n\n
- Controlla la documentazione in
how-to-use.md<\/code>.<\/li>\n\n\n\n- Consulta gli esempi di utilizzo.<\/li>\n<\/ul>\n\n\n\n
Versioni<\/h2>\n\n\n\n\n- 1.0.0<\/strong> – Versione iniziale con supporto per le modalit\u00e0 STDIO e HTTP.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
Un server MCP (Model Context Protocol) per l’esecuzione di script PowerShell, che supporta sia la modalit\u00e0 HTTP che STDIO. In Questo Articolo Descrizione Quale modalit\u00e0 scegliere: HTTP o STDIO? Quando usare la modalit\u00e0 HTTP Quando usare la modalit\u00e0 STDIO Tabella di confronto Caratteristiche Requisiti di sistema Struttura del progetto Avvio rapido Modalit\u00e0 STDIO (per gemini-cli)… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[937],"tags":[942,108,938,939,765,943],"class_list":["post-3466","post","type-post","status-publish","format-standard","hentry","category-mcp-powershell-server","tag-tag-http-mode","tag-tag-mcp","tag-tag-mcp-server","tag-tag-powershell-script-execution","tag-ms-powershell","tag-tag-stdio-mode"],"acf":[],"_links":{"self":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/posts\/3466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/comments?post=3466"}],"version-history":[{"count":0,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/posts\/3466\/revisions"}],"wp:attachment":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/media?parent=3466"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/categories?post=3466"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/tags?post=3466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}