Der MCP PowerShell Server ist ein Server, der das Model Context Protocol (MCP) zur Ausf\u00fchrung von PowerShell-Skripten implementiert. Der Server arbeitet im STDIO-Modus und stellt Werkzeuge zur sicheren Ausf\u00fchrung von PowerShell-Befehlen \u00fcber eine standardisierte Schnittstelle bereit.<\/p>\n\n\n\n
mcp-powershell-stdio.ps1\n\u251c\u2500\u2500 ConvertFrom-JsonToHashtable # JSON-Konvertierungsfunktion\n\u251c\u2500\u2500 Write-Log # Protokollierungsfunktion\n\u251c\u2500\u2500 Test-MCPRequest # MCP-Anforderungsvalidierung\n\u251c\u2500\u2500 New-MCPResponse # Erstellung von MCP-Antworten\n\u251c\u2500\u2500 Invoke-PowerShellScript # Ausf\u00fchrung von PowerShell-Skripten\n\u251c\u2500\u2500 Invoke-MCPMethod # Verarbeitung von MCP-Methoden\n\u251c\u2500\u2500 Send-MCPResponse # Senden von Antworten\n\u251c\u2500\u2500 Start-MCPServer # Hauptschleife des Servers\n\u2514\u2500\u2500 Initialisierung und Start<\/code><\/pre>\n\n\n\nFunktionen<\/h2>\n\n\n\nConvertFrom-JsonToHashtable<\/h3>\n\n\n\nfunction ConvertFrom-JsonToHashtable {\n param([string]$Json)\n}<\/code><\/pre>\n\n\n\nZweck<\/strong>: Diese Funktion konvertiert eine JSON-Zeichenkette in PowerShell-Hashtabellen zur Kompatibilit\u00e4t mit PowerShell 5.x.<\/p>\n\n\n\nParameter<\/strong>:<\/p>\n\n\n\n\nJson<\/code> (string) – Die zu konvertierende JSON-Zeichenkette.<\/li>\n<\/ul>\n\n\n\nR\u00fcckgabewert<\/strong>: Eine Hashtabelle mit den konvertierten Daten.<\/p>\n\n\n\nMerkmale<\/strong>:<\/p>\n\n\n\n\n- Rekursive Konvertierung von verschachtelten Objekten.<\/li>\n\n\n\n
- Verarbeitung von Arrays und Sammlungen.<\/li>\n\n\n\n
- Kompatibilit\u00e4t mit PowerShell 5.x.<\/li>\n<\/ul>\n\n\n\n
Write-Log<\/h3>\n\n\n\nfunction Write-Log {\n param(\n [Parameter(Mandatory=$true)]\n [string]$Message,\n\n [Parameter(Mandatory=$false)]\n [ValidateSet("INFO", "WARNING", "ERROR", "DEBUG")]\n [string]$Level = "INFO"\n )\n}<\/code><\/pre>\n\n\n\nZweck<\/strong>: Diese Funktion schreibt Protokolle in eine Datei, da stdout<\/code> f\u00fcr die MCP-Kommunikation verwendet wird.<\/p>\n\n\n\nParameter<\/strong>:<\/p>\n\n\n\n\nMessage<\/code> (string) – Die Nachricht, die in das Protokoll geschrieben werden soll.<\/li>\n\n\n\nLevel<\/code> (string) – Die Protokollierungsstufe (INFO, WARNING, ERROR, DEBUG).<\/li>\n<\/ul>\n\n\n\nMerkmale<\/strong>:<\/p>\n\n\n\n\n- Schreibt in die Datei
$env:TEMP\\mcp-powershell-server.log<\/code>.<\/li>\n\n\n\n- Zeitstempel im Format
yyyy-MM-dd HH:mm:ss<\/code>.<\/li>\n\n\n\n- UTF-8-Kodierung.<\/li>\n<\/ul>\n\n\n\n
Test-MCPRequest<\/h3>\n\n\n\nfunction Test-MCPRequest {\n param(\n [Parameter(Mandatory=$true)]\n [hashtable]$Request\n )\n}<\/code><\/pre>\n\n\n\nZweck<\/strong>: Diese Funktion validiert eine MCP-Anfrage auf Einhaltung des Protokolls.<\/p>\n\n\n\nParameter<\/strong>:<\/p>\n\n\n\n\nRequest<\/code> (hashtable) – Die zu validierende MCP-Anfrage.<\/li>\n<\/ul>\n\n\n\nR\u00fcckgabewert<\/strong>: Boolean – Das Ergebnis der Validierung.<\/p>\n\n\n\nPr\u00fcfungen<\/strong>:<\/p>\n\n\n\n\n- Vorhandensein des Feldes
jsonrpc<\/code> mit dem Wert „2.0“.<\/li>\n\n\n\n- Vorhandensein des obligatorischen Feldes
method<\/code>.<\/li>\n<\/ul>\n\n\n\nNew-MCPResponse<\/h3>\n\n\n\nfunction New-MCPResponse {\n param(\n [Parameter(Mandatory=$false)]\n [object]$Id = $null,\n\n [Parameter(Mandatory=$false)]\n [object]$Result = $null,\n\n [Parameter(Mandatory=$false)]\n [hashtable]$Error = $null\n )\n}<\/code><\/pre>\n\n\n\nZweck<\/strong>: Diese Funktion erstellt eine standardisierte MCP-Antwort.<\/p>\n\n\n\nParameter<\/strong>:<\/p>\n\n\n\n\nId<\/code> (object) – Der Bezeichner der Anfrage.<\/li>\n\n\n\nResult<\/code> (object) – Das Ergebnis der Operation.<\/li>\n\n\n\nError<\/code> (hashtable) – Informationen \u00fcber den Fehler.<\/li>\n<\/ul>\n\n\n\nR\u00fcckgabewert<\/strong>: Eine Hashtable<\/code> mit der MCP-Antwort.<\/p>\n\n\n\nInvoke-PowerShellScript<\/h3>\n\n\n\nfunction Invoke-PowerShellScript {\n param(\n [Parameter(Mandatory=$true)]\n [string]$Script,\n\n [Parameter(Mandatory=$false)]\n [hashtable]$Parameters = @{},\n\n [Parameter(Mandatory=$false)]\n [int]$TimeoutSeconds = 300,\n\n [Parameter(Mandatory=$false)]\n [string]$WorkingDirectory = $PWD\n )\n}<\/code><\/pre>\n\n\n\nZweck<\/strong>: Diese Funktion f\u00fchrt ein PowerShell-Skript in einem isolierten Prozess aus.<\/p>\n\n\n\nParameter<\/strong>:<\/p>\n\n\n\n\nScript<\/code> (string) – Das auszuf\u00fchrende PowerShell-Skript.<\/li>\n\n\n\nParameters<\/code> (hashtable) – Parameter f\u00fcr das Skript.<\/li>\n\n\n\nTimeoutSeconds<\/code> (int) – Ausf\u00fchrungs-Timeout (Standard 300 Sek.).<\/li>\n\n\n\nWorkingDirectory<\/code> (string) – Das Arbeitsverzeichnis.<\/li>\n<\/ul>\n\n\n\nR\u00fcckgabewert<\/strong>: Eine Hashtable<\/code> mit den Ausf\u00fchrungsergebnissen:<\/p>\n\n\n\n\nsuccess<\/code> (bool) – Der Ausf\u00fchrungsstatus.<\/li>\n\n\n\noutput<\/code> (string) – die Ausgabe des Befehls.<\/li>\n\n\n\nerrors<\/code> (array) – Ein Array von Fehlern.<\/li>\n\n\n\nwarnings<\/code> (array) – Ein Array von Warnungen.<\/li>\n<\/ul>\n\n\n\nMerkmale<\/strong>:<\/p>\n\n\n\n\n- Isolation durch einen separaten PowerShell-Prozess.<\/li>\n\n\n\n
- Timeout-Unterst\u00fctzung.<\/li>\n\n\n\n
- Sammlung aller Ausgabestr\u00f6me (Output, Error, Warning).<\/li>\n\n\n\n
- Automatische Ressourcenbereinigung.<\/li>\n<\/ul>\n\n\n\n
MCP-Methoden<\/h2>\n\n\n\ninitialize<\/h3>\n\n\n\n
Zweck<\/strong>: Initialisiert den MCP-Server und tauscht Informationen \u00fcber F\u00e4higkeiten aus.<\/p>\n\n\n\nAntwort<\/strong>:<\/p>\n\n\n\n{\n "protocolVersion": "2024-11-05",\n "capabilities": {\n "tools": {\n "listChanged": true\n }\n },\n "serverInfo": {\n "name": "PowerShell Script Runner",\n "version": "1.0.0",\n "description": "F\u00fchrt PowerShell-Skripte \u00fcber MCP aus"\n }\n}<\/code><\/pre>\n\n\n\ntools\/list<\/h3>\n\n\n\n
Zweck<\/strong>: Ruft die Liste der verf\u00fcgbaren Werkzeuge ab.<\/p>\n\n\n\nAntwort<\/strong>: Ein Array von Werkzeugen mit Beschreibungen ihrer Eingabeparameterschemata.<\/p>\n\n\n\ntools\/call<\/h3>\n\n\n\n
Zweck<\/strong>: Ruft ein bestimmtes Werkzeug mit Parametern auf.<\/p>\n\n\n\nParameter<\/strong>:<\/p>\n\n\n\n\nname<\/code> (string) – Der Name des Werkzeugs.<\/li>\n\n\n\narguments<\/code> (object) – Argumente f\u00fcr das Werkzeug.<\/li>\n<\/ul>\n\n\n\nWerkzeuge<\/h2>\n\n\n\nrun-script<\/h3>\n\n\n\n
Zweck<\/strong>: F\u00fchrt ein PowerShell-Skript mit angegebenen Parametern aus.<\/p>\n\n\n\nEingabeparameterschema<\/strong>:<\/p>\n\n\n\n{\n "type": "object",\n "properties": {\n "script": {\n "type": "string",\n "description": "Auszuf\u00fchrendes PowerShell-Skript"\n },\n "parameters": {\n "type": "object",\n "description": "Parameter f\u00fcr das Skript (optional)",\n "additionalProperties": true\n },\n "workingDirectory": {\n "type": "string",\n "description": "Arbeitsverzeichnis f\u00fcr die Ausf\u00fchrung (optional)",\n "default": "<aktuelles Verzeichnis>"\n },\n "timeoutSeconds": {\n "type": "integer",\n "description": "Ausf\u00fchrungs-Timeout in Sekunden (optional)",\n "default": 300,\n "minimum": 1,\n "maximum": 3600\n }\n },\n "required": ["script"]\n}<\/code><\/pre>\n\n\n\nAntwort<\/strong>: Eine Struktur mit den Ausf\u00fchrungsergebnissen, einschlie\u00dflich:<\/p>\n\n\n\n\n- Formatierte Befehlsausgabe.<\/li>\n\n\n\n
- Fehler (falls vorhanden).<\/li>\n\n\n\n
- Warnungen (falls vorhanden).<\/li>\n\n\n\n
- Ausf\u00fchrungsmetadaten.<\/li>\n<\/ul>\n\n\n\n
Konfiguration<\/h2>\n\n\n\nKodierung<\/h3>\n\n\n\n[Console]::OutputEncoding = [System.Text.Encoding]::UTF8\n[Console]::InputEncoding = [System.Text.Encoding]::UTF8<\/code><\/pre>\n\n\n\nDer Server ist f\u00fcr die Arbeit mit UTF-8-Kodierung zur korrekten Verarbeitung von JSON-Daten konfiguriert.<\/p>\n\n\n\n
Protokollierung (Logging)<\/h3>\n\n\n\n\n- Protokolldatei<\/strong>:
$env:TEMP\\mcp-powershell-server.log<\/code><\/li>\n\n\n\n- Kodierung<\/strong>: UTF-8<\/li>\n\n\n\n
- Stufen<\/strong>: INFO, WARNING, ERROR, DEBUG<\/li>\n\n\n\n
- Format<\/strong>:
[yyyy-MM-dd HH:mm:ss] [LEVEL] Nachricht<\/code><\/li>\n<\/ul>\n\n\n\nSicherheit<\/h3>\n\n\n\n\n- Skriptisolierung durch separate PowerShell-Prozesse.<\/li>\n\n\n\n
- Timeouts zur Verhinderung von H\u00e4ngenbleiben.<\/li>\n\n\n\n
- Validierung aller eingehenden Anfragen.<\/li>\n\n\n\n
- Protokollierung aller Operationen.<\/li>\n<\/ul>\n\n\n\n
Verwendung<\/h2>\n\n\n\nStarten des Servers<\/h3>\n\n\n\n.\\mcp-powershell-stdio.ps1<\/code><\/pre>\n\n\n\nDer Server startet im STDIO-Modus und wartet auf MCP-Befehle \u00fcber die Standardeingabe.<\/p>\n\n\n\n
Beispiel-MCP-Anfragen<\/h3>\n\n\n\nInitialisierung<\/h4>\n\n\n\n{\n "jsonrpc": "2.0",\n "id": 1,\n "method": "initialize",\n "params": {\n "protocolVersion": "2024-11-05",\n "capabilities": {},\n "clientInfo": {\n "name": "test-client",\n "version": "1.0.0"\n }\n }\n}<\/code><\/pre>\n\n\n\nListe der Werkzeuge„`json<\/h4>\n\n\n\n
{
„jsonrpc“: „2.0“,
„id“: 2,
„method“: „tools\/list“
}<\/p>\n\n\n\n
#### Skriptausf\u00fchrung<\/code><\/pre>\n\n\n\njson
{
„jsonrpc“: „2.0“,
„id“: 3,
„method“: „tools\/call“,
„params“: {
„name“: „run-script“,
„arguments“: {
„script“: „Get-Process | Select-Object -First 5 Name, CPU“,
„timeoutSeconds“: 60
}
}
}
„`<\/p>\n\n\n\n
Fehlerbehandlung<\/h2>\n\n\n\nMCP-Fehlercodes<\/h3>\n\n\n\n\n-32700<\/code>: JSON-Parse-Fehler<\/li>\n\n\n\n-32600<\/code>: Ung\u00fcltige MCP-Anfrage<\/li>\n\n\n\n-32601<\/code>: Methode oder Werkzeug nicht gefunden<\/li>\n\n\n\n-32602<\/code>: Ung\u00fcltige Parameter<\/li>\n\n\n\n-32603<\/code>: Interner Serverfehler<\/li>\n<\/ul>\n\n\n\nFehlerprotokollierung<\/h3>\n\n\n\n
Alle Fehler werden in einer Datei mit detaillierten Informationen protokolliert:<\/p>\n\n\n\n
\n- Zeitstempel<\/li>\n\n\n\n
- Fehlerstufe<\/li>\n\n\n\n
- Detaillierte Beschreibung<\/li>\n\n\n\n
- Stack-Trace (falls erforderlich)<\/li>\n<\/ul>\n\n\n\n
Einschr\u00e4nkungen<\/h2>\n\n\n\n\n- Ausf\u00fchrungs-Timeout<\/strong>: Maximal 3600 Sekunden (1 Stunde).<\/li>\n\n\n\n
- Prozessisolierung<\/strong>: Jedes Skript wird in einem separaten Prozess ausgef\u00fchrt.<\/li>\n\n\n\n
- Kodierung<\/strong>: Nur UTF-8.<\/li>\n\n\n\n
- Kompatibilit\u00e4t<\/strong>: PowerShell 5.x und h\u00f6her.<\/li>\n<\/ol>\n\n\n\n
Leistung<\/h2>\n\n\n\n\n- Minimaler Overhead bei der Prozesserstellung.<\/li>\n\n\n\n
- Effiziente JSON-Serialisierung.<\/li>\n\n\n\n
- Automatische Ressourcenbereinigung.<\/li>\n\n\n\n
- Optimierte Protokollierung.<\/li>\n<\/ul>\n\n\n\n
Skalierbarkeit<\/h2>\n\n\n\n
Der Server ist daf\u00fcr ausgelegt, eine Anfrage nach der anderen im synchronen Modus zu verarbeiten. F\u00fcr die parallele Verarbeitung m\u00fcssen mehrere Instanzen des Servers ausgef\u00fchrt werden.<\/p>\n\n\n\n
\n\n\n\nDokumentationsversion: 1.0.0<\/em>
Erstellungsdatum: 15. September 2025<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"Beschreibung Der MCP PowerShell Server ist ein Server, der das Model Context Protocol (MCP) zur Ausf\u00fchrung von PowerShell-Skripten implementiert. Der Server arbeitet im STDIO-Modus und stellt Werkzeuge zur sicheren Ausf\u00fchrung von PowerShell-Befehlen \u00fcber eine standardisierte Schnittstelle bereit. Architektur Hauptkomponenten Dateistruktur Funktionen ConvertFrom-JsonToHashtable Zweck: Diese Funktion konvertiert eine JSON-Zeichenkette in PowerShell-Hashtabellen zur Kompatibilit\u00e4t mit PowerShell 5.x.… <\/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-3512","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3512","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=3512"}],"version-history":[{"count":0,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3512\/revisions"}],"wp:attachment":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/media?parent=3512"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/categories?post=3512"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/tags?post=3512"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}