Hauptmerkmale:<\/strong><\/p>\n\n\n\n Voraussetzungen:<\/strong><\/p>\n\n\n\n Befehlszeilenparameter:<\/strong><\/p>\n\n\n\n Anwendungsbeispiel:<\/strong><\/p>\n\n\n\n Konfigurationsdatei ( Der Server kann seine Konfiguration aus einer JSON-Datei laden. Dies ist der empfohlene Ansatz f\u00fcr Produktionsumgebungen.<\/p>\n\n\n\n Beispiel Das Skript ist logisch in mehrere Regionen (mcp-powershell-http.ps1<\/code> ist ein eigenst\u00e4ndiger HTTP-Server, der in PowerShell geschrieben wurde, um PowerShell-Skripte sicher aus der Ferne auszuf\u00fchren. Er fungiert als „Br\u00fccke“ zwischen einem externen Client (z. B. einem KI-Assistenten) und der lokalen PowerShell-Umgebung und verwendet f\u00fcr die Kommunikation das JSON-RPC 2.0-Protokoll.<\/p>\n\n\n\n\n
Runspace<\/code>) ausgef\u00fchrt, was Auswirkungen auf die Hauptumgebung des Servers verhindert.<\/li>\n\n\n\ninitialize<\/code>, tools\/list<\/code> und tools\/call<\/code>.<\/li>\n\n\n\n2. Ausf\u00fchrung und Konfiguration<\/h4>\n\n\n\n
\n
Parameter<\/th> Typ<\/th> Beschreibung<\/th> Standardwert<\/th><\/tr><\/thead> -Port<\/code><\/td>[int]<\/code><\/td>Der Port, an dem der Server auf HTTP-Anfragen lauscht.<\/td> 8090<\/code><\/td><\/tr>-ServerHost<\/code><\/td>[string]<\/code><\/td>Der Host (IP-Adresse oder Domainname), an den der Server gebunden wird.<\/td> localhost<\/code><\/td><\/tr>-ConfigFile<\/code><\/td>[string]<\/code><\/td>Der Pfad zu einer Konfigurationsdatei im JSON-Format. Parameter aus dieser Datei \u00fcberschreiben die Standardwerte und Befehlszeilenargumente.<\/td> $null<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n.\\mcp-powershell-http.ps1 -Port 8090 -ServerHost 0.0.0.0 -ConfigFile "C:\\config\\settings.json"<\/code><\/pre>\n\n\n\nsettings.json<\/code>):<\/strong><\/p>\n\n\n\nsettings.json<\/code> aus dem Repository:<\/em><\/p>\n\n\n\n{\n "Port": 8090,\n "Host": "localhost",\n "MaxConcurrentRequests": 10,\n "TimeoutSeconds": 300,\n "LogLevel": "INFO",\n "AllowedPaths": [\n "C:\\\\Scripts\\\\",\n "C:\\\\Users\\\\%USERNAME%\\\\Documents\\\\"\n ],\n "Security": {\n "EnableScriptValidation": false,\n "BlockDangerousCommands": false,\n "RestrictedCommands": [\n "Remove-Item -Path C:\\\\Windows\\\\*",\n "Format-Volume"\n ]\n }\n}<\/code><\/pre>\n\n\n\n3. Architektur und Funktionen<\/h4>\n\n\n\n
#region<\/code>) unterteilt, um die Navigation zu vereinfachen.<\/p>\n\n\n\nRegion:
Utility Functions<\/code> (Hilfsfunktionen)<\/strong><\/h5>\n\n\n\n\n
Write-Log<\/code><\/strong>\n\n
\n
$Message<\/code> [string]<\/code> (obligatorisch): Der Nachrichtentext.<\/li>\n\n\n\n$Level<\/code> [string]<\/code> (optional): Die Protokollierungsstufe (DEBUG<\/code>, INFO<\/code>, WARNING<\/code>, ERROR<\/code>). Beeinflusst die Farbe der Ausgabe.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\nTest-MCPRequest<\/code><\/strong>\n\n
jsonrpc: "2.0"<\/code> und method<\/code>).<\/li>\n\n\n\n\n
$Request<\/code> [hashtable]<\/code> (obligatorisch): Die aus JSON deserialisierte Anfrage.<\/li>\n<\/ul>\n<\/li>\n\n\n\n$true<\/code>, wenn die Anfrage g\u00fcltig ist, andernfalls $false<\/code>.<\/li>\n<\/ul>\n<\/li>\n\n\n\nNew-MCPResponse<\/code><\/strong>\n\n
\n
$Id<\/code> [object]<\/code>: Der Bezeichner der Anfrage.<\/li>\n\n\n\n$Result<\/code> [object]<\/code>: Das Objekt, das ein erfolgreiches Ergebnis enth\u00e4lt.<\/li>\n\n\n\n$Error<\/code> [hashtable]<\/code>: Das Objekt, das Fehlerinformationen enth\u00e4lt.<\/li>\n<\/ul>\n<\/li>\n\n\n\n[hashtable]<\/code> mit der vollst\u00e4ndigen Antwortstruktur.<\/li>\n<\/ul>\n<\/li>\n\n\n\nTest-ScriptSafety<\/code><\/strong>\n\n
$script:RestrictedCommands<\/code> aufgef\u00fchrt sind.<\/li>\n\n\n\nreturn $true<\/code>). F\u00fcr den Produktionseinsatz sollte sie aktiviert und konfiguriert werden.<\/li>\n\n\n\n\n
$Script<\/code> [string]<\/code> (obligatorisch): Der zu \u00fcberpr\u00fcfende PowerShell-Skripttext.<\/li>\n<\/ul>\n<\/li>\n\n\n\n$true<\/code>, wenn das Skript sicher ist, andernfalls $false<\/code>.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\nRegion:
Core Logic<\/code> (Kernlogik)<\/strong><\/h5>\n\n\n\n\n
Invoke-PowerShellScript<\/code><\/strong>\n\n
\n
[powershell]::Create()<\/code>).<\/li>\n\n\n\nOutput<\/code>)-, Fehler (Error<\/code>)- und Warnungs (Warning<\/code>)-Streams.<\/li>\n\n\n\nDispose()<\/code>).<\/li>\n<\/ol>\n<\/li>\n\n\n\n\n
$Script<\/code> [string]<\/code> (obligatorisch): Der auszuf\u00fchrende Code.<\/li>\n\n\n\n$Parameters<\/code> [hashtable]<\/code>: Parameter, die an das Skript \u00fcbergeben werden.<\/li>\n\n\n\n$TimeoutSeconds<\/code> [int]<\/code>: Maximale Ausf\u00fchrungszeit in Sekunden.<\/li>\n\n\n\n$WorkingDirectory<\/code> [string]<\/code>: Das Arbeitsverzeichnis f\u00fcr das Skript.<\/li>\n<\/ul>\n<\/li>\n\n\n\n[hashtable]<\/code> mit den Ergebnissen: success<\/code> (bool), output<\/code> (string), errors<\/code> (array), warnings<\/code> (array), executionTime<\/code> (double).<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\nRegion:
MCP Protocol Methods<\/code> (MCP-Protokollmethoden)<\/strong><\/h5>\n\n\n\n\n
Invoke-MCPMethod<\/code><\/strong>\n\n
switch<\/code>-Anweisung auf den Methodennamen ($Method<\/code>), um die entsprechende Logik aufzurufen.<\/li>\n\n\n\n\n
"initialize"<\/code>: Gibt Informationen \u00fcber den Server zur\u00fcck.<\/li>\n\n\n\n"tools\/list"<\/code>: Gibt eine Liste der verf\u00fcgbaren Tools zur\u00fcck (in diesem Fall nur "run-script"<\/code>).<\/li>\n\n\n\n"tools\/call"<\/code>: Verarbeitet einen Tool-Aufruf. Extrahiert die Parameter und ruft Invoke-PowerShellScript<\/code> zur Ausf\u00fchrung auf.<\/li>\n<\/ul>\n<\/li>\n\n\n\n\n
$Method<\/code> [string]<\/code>: Der Name der aufzurufenden Methode.<\/li>\n\n\n\n$Params<\/code> [hashtable]<\/code>: Die Parameter der Methode.<\/li>\n\n\n\n$Id<\/code> [object]<\/code>: Der Bezeichner der Anfrage.<\/li>\n<\/ul>\n<\/li>\n\n\n\n[hashtable]<\/code>, die die vollst\u00e4ndige, sendebereite MCP-Antwort darstellt.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\nRegion:
HTTP Server<\/code><\/strong><\/h5>\n\n\n\n\n
Invoke-RequestHandler<\/code><\/strong>\n\n
\n
OPTIONS<\/code>-Anfragen (CORS-Preflight).<\/li>\n\n\n\nPOST<\/code> ist.<\/li>\n\n\n\nTest-MCPRequest<\/code> zur Validierung auf.<\/li>\n\n\n\nInvoke-MCPMethod<\/code>.<\/li>\n\n\n\n\n