Ein MCP (Model Context Protocol) Server zur Ausf\u00fchrung von PowerShell-Skripten, der sowohl den HTTP- als auch den STDIO-Betriebsmodus unterst\u00fctzt.<\/p>\n\n\n\n
Der MCP PowerShell Server erm\u00f6glicht es KI-Assistenten, PowerShell-Befehle und -Skripte \u00fcber das standardisierte MCP-Protokoll auszuf\u00fchren. Der Server unterst\u00fctzt zwei Betriebsmodi:<\/p>\n\n\n\n
gemini-cli<\/code> und anderen lokalen MCP-Clients.<\/li>\n\n\n\n- HTTP-Modus<\/strong>: F\u00fcr Webanwendungen und die Netzwerkintegration \u00fcber eine REST-API.<\/li>\n<\/ul>\n\n\n\n
Welchen Modus w\u00e4hlen: HTTP oder STDIO?<\/h2>\n\n\n\n
Die Wahl zwischen mcp-powershell-http.ps1<\/code> und mcp-powershell-stdio.ps1<\/code> h\u00e4ngt davon ab, wie und von wo<\/strong> die Client-Anwendung mit dem Server interagieren wird.<\/p>\n\n\n\n\nmcp-powershell-http.ps1<\/code> (HTTP-Modus)<\/strong> arbeitet wie ein Kellner in einem Restaurant<\/strong>. Er nimmt Bestellungen (HTTP-Anfragen) von jedem Client im Netzwerk entgegen, leitet sie an die „K\u00fcche“ (PowerShell) weiter und gibt das fertige Ergebnis (HTTP-Antwort) zur\u00fcck.<\/li>\n\n\n\nmcp-powershell-stdio.ps1<\/code> (STDIO-Modus)<\/strong> arbeitet wie ein pers\u00f6nlicher Assistent in der K\u00fcche<\/strong>. Er erh\u00e4lt Aufgaben direkt (\u00fcber die Standardeingabe stdin<\/code>) von einem steuernden Prozess (z. B. gemini-cli<\/code>), der ihn selbst gestartet hat, und gibt das Ergebnis sofort zur\u00fcck (\u00fcber die Standardausgabe stdout<\/code>).<\/li>\n<\/ul>\n\n\n\nWann sollte der HTTP-Modus verwendet werden?<\/h3>\n\n\n\n
Sie sollten HTTP w\u00e4hlen, wenn eine Netzwerkkommunikation<\/strong> erforderlich ist.<\/p>\n\n\n\n\n- Fernverwaltung:<\/strong> Die Client-Anwendung befindet sich auf einem anderen Computer.<\/li>\n\n\n\n
- Web-Integration:<\/strong> Sie m\u00fcssen PowerShell-Skripte aus einer Webanwendung, einem Admin-Panel oder \u00fcber AJAX-Anfragen aufrufen.<\/li>\n\n\n\n
- Microservice-Architektur:<\/strong> Andere Dienste in Ihrem Netzwerk m\u00fcssen mit PowerShell interagieren.<\/li>\n\n\n\n
- Einfaches Testen:<\/strong> Sie m\u00f6chten Werkzeuge wie
curl<\/code>, Postman oder Invoke-RestMethod<\/code> zum Senden von Befehlen verwenden.<\/li>\n<\/ul>\n\n\n\n\nEinfach ausgedr\u00fcckt:<\/strong> W\u00e4hlen Sie HTTP, wenn sich zwischen dem Client und dem Server ein Netzwerk<\/strong> befindet.<\/p>\n<\/blockquote>\n\n\n\nWann sollte der STDIO-Modus verwendet werden?<\/h3>\n\n\n\n
Dieser Modus ist ideal f\u00fcr eine lokale und sichere Integration<\/strong>.<\/p>\n\n\n\n\n- Hauptszenario \u2013 Gemini CLI:<\/strong> Das
gemini-cli<\/code>-Werkzeug startet mcp-powershell-stdio.ps1<\/code> als untergeordneten Prozess und kommuniziert direkt \u00fcber die Standard-Ein-\/Ausgabestr\u00f6me mit ihm.<\/li>\n\n\n\n- Integration mit anderen lokalen Anwendungen:<\/strong> Ihr Programm in Python, Node.js oder einer anderen Sprache kann den Server starten und verwalten, ohne Netzwerkports zu \u00f6ffnen.<\/li>\n\n\n\n
- Erh\u00f6hte Sicherheit:<\/strong> Da keine Netzwerkports ge\u00f6ffnet werden, ist diese Methode standardm\u00e4\u00dfig sicherer.<\/li>\n<\/ul>\n\n\n\n
\nEinfach ausgedr\u00fcckt:<\/strong> W\u00e4hlen Sie STDIO, wenn sich Client und Server auf derselben Maschine<\/strong> befinden und der Client den Server selbst startet.<\/p>\n<\/blockquote>\n\n\n\nVergleichstabelle<\/h3>\n\n\n\nMerkmal<\/th> HTTP-Modus (mcp-powershell-http.ps1<\/code>)<\/th>STDIO-Modus (mcp-powershell-stdio.ps1<\/code>)<\/th><\/tr><\/thead>Hauptszenario<\/strong><\/td>Netzwerkkommunikation, Web-API<\/td> Lokale Integration mit CLI-Werkzeugen<\/td><\/tr> Kommunikationstyp<\/strong><\/td>Client-Server \u00fcber das Netzwerk (TCP\/IP)<\/td> Interprozesskommunikation (IPC)<\/td><\/tr> Standort<\/strong><\/td>Client und Server k\u00f6nnen sich auf unterschiedlichen Maschinen befinden<\/td> Client und Server m\u00fcssen<\/strong> sich auf derselben Maschine befinden<\/td><\/tr>Sicherheit<\/strong><\/td>Erfordert Aufmerksamkeit (Portzugriff, Firewall)<\/td> Standardm\u00e4\u00dfig sicherer (keine offenen Ports)<\/td><\/tr> Typische Clients<\/strong><\/td>curl<\/code>, Postman, Webanwendungen, Remote-Skripte<\/td>gemini-cli<\/code>, lokale Wrapper-Anwendungen<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nFunktionen<\/h2>\n\n\n\n\n- \u2705 Unterst\u00fctzung f\u00fcr das MCP-Protokoll Version 2024-11-05<\/li>\n\n\n\n
- \u2705 Zwei Betriebsmodi: STDIO und HTTP<\/li>\n\n\n\n
- \u2705 Isolierung der Skriptausf\u00fchrung in separaten PowerShell-Prozessen<\/li>\n\n\n\n
- \u2705 Konfigurierbare Ausf\u00fchrungs-Timeouts<\/li>\n\n\n\n
- \u2705 Detaillierte Protokollierung aller Vorg\u00e4nge<\/li>\n\n\n\n
- \u2705 Behandlung von PowerShell-Fehlern und -Warnungen<\/li>\n\n\n\n
- \u2705 Unterst\u00fctzung f\u00fcr Skriptparameter<\/li>\n\n\n\n
- \u2705 Konfigurierbares Arbeitsverzeichnis<\/li>\n\n\n\n
- \u2705 Automatische Launcher zur Vereinfachung des Starts<\/li>\n<\/ul>\n\n\n\n
Systemanforderungen<\/h2>\n\n\n\n\n- PowerShell 7.0 oder neuer<\/li>\n\n\n\n
- Windows 10\/11 oder Windows Server 2019+<\/li>\n\n\n\n
- .NET 6.0 oder neuer<\/li>\n<\/ul>\n\n\n\n
Projektstruktur<\/h2>\n\n\n\nmcp-powershell-server\/\n\u251c\u2500\u2500 src\/\n\u2502 \u251c\u2500\u2500 clients\/ # Client-Anwendungen\n\u2502 \u2502 \u251c\u2500\u2500 node\/ # Node.js-Client\n\u2502 \u2502 \u251c\u2500\u2500 powershell\/ # PowerShell-Client\n\u2502 \u2502 \u2514\u2500\u2500 python\/ # Python-Client\n\u2502 \u2514\u2500\u2500 servers\/ # Server-Komponenten\n\u2502 \u251c\u2500\u2500 mcp-powershell-stdio.ps1 # STDIO-Version des Servers\n\u2502 \u251c\u2500\u2500 mcp-powershell-http.ps1 # HTTP-Version des Servers\n\u2502 \u251c\u2500\u2500 test-mcp.ps1 # Testserver\n\u2502 \u2514\u2500\u2500 config.json # Konfigurationsdatei\n\u251c\u2500\u2500 docs\/ # Dokumentation\n\u251c\u2500\u2500 README.md # Diese Datei\n\u2514\u2500\u2500 how-to-use.md # Detaillierte Anleitung<\/code><\/pre>\n\n\n\nSchnellstart<\/h2>\n\n\n\nSTDIO-Modus (f\u00fcr gemini-cli)<\/h3>\n\n\n\n\n- Server starten:<\/strong>
powershell .\\src\\servers\\mcp-powershell-stdio.ps1<\/code><\/li>\n\n\n\n- Testen:<\/strong>
powershell .\\src\\servers\\test-mcp.ps1<\/code><\/li>\n<\/ol>\n\n\n\nHTTP-Modus<\/h3>\n\n\n\n\n- Grundlegender Start:<\/strong>
powershell .\\src\\servers\\mcp-powershell-http.ps1<\/code><\/li>\n\n\n\n- Mit benutzerdefinierten Parametern:<\/strong>
powershell .\\src\\servers\\mcp-powershell-http.ps1 -Port 9090 -ServerHost "0.0.0.0"<\/code><\/li>\n\n\n\n- Mit Konfigurationsdatei:<\/strong>
powershell .\\src\\servers\\mcp-powershell-http.ps1 -ConfigFile ".\\src\\servers\\config.json"<\/code><\/li>\n<\/ol>\n\n\n\nVerf\u00fcgbare MCP-Werkzeuge<\/h2>\n\n\n\nrun-script<\/code><\/h3>\n\n\n\nF\u00fchrt ein PowerShell-Skript mit den angegebenen Parametern aus.<\/p>\n\n\n\n
Parameter:<\/strong><\/p>\n\n\n\n\nscript<\/code> (erforderlich) – Auszuf\u00fchrender PowerShell-Code<\/li>\n\n\n\nparameters<\/code> (optional) – Hashtabelle mit Parametern<\/li>\n\n\n\nworkingDirectory<\/code> (optional) – Arbeitsverzeichnis<\/li>\n\n\n\ntimeoutSeconds<\/code> (optional) – Ausf\u00fchrungs-Timeout (1-3600 Sek.)<\/li>\n<\/ul>\n\n\n\nAnwendungsbeispiel \u00fcber 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\nKonfiguration<\/h2>\n\n\n\n
Der Server unterst\u00fctzt die Konfiguration \u00fcber die Datei 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\nSicherheit<\/h2>\n\n\n\n\n- Die Skriptausf\u00fchrung erfolgt in isolierten PowerShell-Prozessen<\/li>\n\n\n\n
- Unterst\u00fctzung einer Liste verbotener Befehle<\/li>\n\n\n\n
- Begrenzung der Ausf\u00fchrungszeit<\/li>\n\n\n\n
- Protokollierung aller ausgef\u00fchrten Befehle<\/li>\n\n\n\n
- M\u00f6glichkeit zur Einschr\u00e4nkung der verf\u00fcgbaren Pfade<\/li>\n<\/ul>\n\n\n\n
Protokollierung (Logging)<\/h2>\n\n\n\n\n- STDIO-Modus<\/strong>: Protokolle werden in
%TEMP%\\mcp-powershell-server.log<\/code> geschrieben<\/li>\n\n\n\n- HTTP-Modus<\/strong>: Protokolle werden in der Konsole mit farblicher Hervorhebung ausgegeben<\/li>\n<\/ul>\n\n\n\n
Protokollstufen: DEBUG, INFO, WARNING, ERROR<\/p>\n\n\n\n
Integration mit KI-Assistenten<\/h2>\n\n\n\nGemini CLI<\/h3>\n\n\n\ngemini --mcp-config "path\/to\/mcp_servers.json" -m gemini-2.5-pro -p "Zeige die ersten 5 Prozesse im System an"<\/code><\/pre>\n\n\n\nAndere MCP-Clients<\/h3>\n\n\n\n
Der Server ist mit allen Clients kompatibel, die das MCP-Protokoll 2024-11-05 unterst\u00fctzen.<\/p>\n\n\n\n
Fehlerbehebung<\/h2>\n\n\n\nH\u00e4ufige Probleme<\/h3>\n\n\n\n\n- Port belegt<\/strong>: \u00c4ndern Sie den Port in der Konfiguration oder beenden Sie den Prozess, der den Port verwendet.<\/li>\n\n\n\n
- Zugriffsrechte<\/strong>: Das Ausf\u00fchren auf privilegierten Ports (<1024) erfordert Administratorrechte.<\/li>\n\n\n\n
- Zeichenkodierung<\/strong>: Stellen Sie sicher, dass PowerShell auf UTF-8 konfiguriert ist.<\/li>\n\n\n\n
- PowerShell-Version<\/strong>: PowerShell 7+ ist erforderlich.<\/li>\n<\/ol>\n\n\n\n
Diagnose<\/h3>\n\n\n\n
\u00dcberpr\u00fcfen Sie die Serverprotokolle zur Problemdiagnose:<\/p>\n\n\n\n
Get-Content "$env:TEMP\\mcp-powershell-server.log" -Tail 20<\/code><\/pre>\n\n\n\nEntwicklung und Erweiterung<\/h2>\n\n\n\n
Der Server kann leicht um neue MCP-Werkzeuge erweitert werden. Siehe how-to-use.md<\/code> f\u00fcr detaillierte Entwicklungsanweisungen.<\/p>\n\n\n\nLizenz<\/h2>\n\n\n\n
Dieses Projekt wird unter der MIT-Lizenz vertrieben. Siehe die LICENSE-Datei f\u00fcr Details.<\/p>\n\n\n\n
Support<\/h2>\n\n\n\n\n- Erstellen Sie ein „Issue“ im GitHub-Repository.<\/li>\n\n\n\n
- \u00dcberpr\u00fcfen Sie die Dokumentation in
how-to-use.md<\/code>.<\/li>\n\n\n\n- Sehen Sie sich die Anwendungsbeispiele an.<\/li>\n<\/ul>\n\n\n\n
Versionen<\/h2>\n\n\n\n\n- 1.0.0<\/strong> – Erstversion mit Unterst\u00fctzung f\u00fcr STDIO- und HTTP-Modi.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
Ein MCP (Model Context Protocol) Server zur Ausf\u00fchrung von PowerShell-Skripten, der sowohl den HTTP- als auch den STDIO-Betriebsmodus unterst\u00fctzt.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"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":[],"tags":[],"class_list":["post-3466","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/comments?post=3466"}],"version-history":[{"count":0,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3466\/revisions"}],"wp:attachment":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/media?parent=3466"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/categories?post=3466"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/tags?post=3466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}