שרת MCP (Model Context Protocol) להרצת סקריפטים של PowerShell, התומך במצבי עבודה HTTP ו-STDIO.

תיאור

שרת MCP PowerShell מאפשר לעוזרי AI להריץ פקודות וסקריפטים של PowerShell דרך פרוטוקול MCP המתוקנן. השרת תומך בשני מצבי עבודה:

• מצב STDIO: לאינטגרציה עם gemini-cli ולקוחות MCP מקומיים אחרים.
• מצב HTTP: ליישומי אינטרנט ואינטגרציה ברשת דרך REST API.

באיזה מצב לבחור: HTTP או STDIO?

הבחירה בין mcp-powershell-http.ps1 לבין mcp-powershell-stdio.ps1 תלויה באיך ומאיפה אפליקציית הלקוח תתקשר עם השרת.

• mcp-powershell-http.ps1 (מצב HTTP) עובד כמו מלצר במסעדה. הוא מקבל הזמנות (בקשות HTTP) מכל לקוח ברשת, מעביר אותן ל"מטבח" (PowerShell) ומחזיר את התוצאה המוכנה (תשובת HTTP).
• mcp-powershell-stdio.ps1 (מצב STDIO) עובד כמו עוזר אישי במטבח. הוא מקבל משימות ישירות (דרך קלט סטנדרטי stdin) מתהליך מנהל (למשל, gemini-cli) שהפעיל אותו, ומחזיר מיד את התוצאה (דרך פלט סטנדרטי stdout).

מתי להשתמש במצב HTTP

כדאי לבחור ב-HTTP אם נדרשת תקשורת רשת.

• ניהול מרחוק: אפליקציית הלקוח נמצאת על מחשב אחר.
• אינטגרציית אינטרנט: יש צורך לקרוא לסקריפטים של PowerShell מיישום אינטרנט, פאנל ניהול או דרך בקשות AJAX.
• ארכיטקטורת מיקרו-שירותים: שירותים אחרים ברשת שלך צריכים לתקשר עם PowerShell.
• בדיקות פשוטות: אתה רוצה להשתמש בכלים כמו curl, Postman או Invoke-RestMethod כדי לשלוח פקודות.

במילים פשוטות: בחר HTTP אם יש רשת בין הלקוח לשרת.

מתי להשתמש במצב STDIO

מצב זה אידיאלי עבור אינטגרציה מקומית ומאובטחת.

• תרחיש עיקרי — Gemini CLI: הכלי gemini-cli מפעיל בעצמו את mcp-powershell-stdio.ps1 כתהליך בן ומתקשר איתו ישירות דרך זרמי קלט/פלט סטנדרדטיים.
• אינטגרציה עם יישומים מקומיים אחרים: התוכנית שלך ב-Python, Node.js או שפה אחרת יכולה להפעיל ולנהל את השרת מבלי לפתוח פורטים ברשת.
• אבטחה מוגברת: מכיוון שאין פתיחת פורטים ברשת, שיטה זו מאובטחת יותר כברירת מחדל.

במילים פשוטות: בחר STDIO אם הלקוח והשרת נמצאים על אותה מכונה, והלקוח מפעיל את השרת בעצמו.

טבלת השוואה

מאפיין	מצב HTTP (mcp-powershell-http.ps1)	מצב STDIO (mcp-powershell-stdio.ps1)
תרחיש עיקרי	תקשורת רשת, Web API	אינטגרציה מקומית עם כלי CLI
סוג תקשורת	לקוח-שרת ברשת (TCP/IP)	תקשורת בין תהליכים (IPC)
מיקום	הלקוח והשרת יכולים להיות על מכונות שונות	הלקוח והשרת חייבים להיות על אותה מכונה
אבטחה	דורש תשומת לב (גישה לפורט, חומת אש)	מאובטח יותר כברירת מחדל (אין פורטים פתוחים)
לקוחות טיפוסיים	curl, Postman, יישומי אינטרנט, סקריפטים מרוחקים	gemini-cli, יישומי עטיפה מקומיים

תכונות

• ✅ תמיכה בפרוטוקול MCP גרסה 2024-11-05
• ✅ שני מצבי עבודה: STDIO ו-HTTP
• ✅ בידוד הרצת סקריפטים בתהליכי PowerShell נפרדים
• ✅ זמני קצוב (timeout) ניתנים להגדרה
• ✅ רישום מפורט של כל הפעולות
• ✅ טיפול בשגיאות ואזהרות של PowerShell
• ✅ תמיכה בפרמטרים לסקריפטים
• ✅ ספריית עבודה ניתנת להגדרה
• ✅ מפעילים אוטומטיים להפעלה פשוטה

דרישות מערכת

• PowerShell 7.0 ומעלה
• Windows 10/11 או Windows Server 2019+
• .NET 6.0 ומעלה

מבנה הפרויקט

mcp-powershell-server/
├── src/
│   ├── clients/           # יישומי לקוח
│   │   ├── node/         # לקוח Node.js
│   │   ├── powershell/   # לקוח PowerShell
│   │   └── python/       # לקוח Python
│   └── servers/          # רכיבי שרת
│       ├── mcp-powershell-stdio.ps1   # גרסת STDIO של השרת
│       ├── mcp-powershell-http.ps1    # גרסת HTTP של השרת
│       ├── test-mcp.ps1               # שרת בדיקות
│       └── config.json                # קובץ תצורה
├── docs/                 # תיעוד
├── README.md            # קובץ זה
└── how-to-use.md        # מדריך שימוש מפורט

התחלה מהירה

מצב STDIO (עבור gemini-cli)

1. הפעלת השרת:
   powershell .\src\servers\mcp-powershell-stdio.ps1
2. בדיקה:
   powershell .\src\servers\test-mcp.ps1

מצב HTTP

1. הפעלה בסיסית:
   powershell .\src\servers\mcp-powershell-http.ps1
2. עם פרמטרים מותאמים אישית:
   powershell .\src\servers\mcp-powershell-http.ps1 -Port 9090 -ServerHost "0.0.0.0"
3. עם קובץ תצורה:
   powershell .\src\servers\mcp-powershell-http.ps1 -ConfigFile ".\src\servers\config.json"

כלי MCP זמינים

run-script

מריץ סקריפט PowerShell עם פרמטרים שצוינו.

פרמטרים:

• script (חובה) – קוד PowerShell להרצה
• parameters (אופציונלי) – טבלת גיבוב של פרמטרים
• workingDirectory (אופציונלי) – ספריית העבודה
• timeoutSeconds (אופציונלי) – זמן קצוב להרצה (1-3600 שניות)

דוגמה לשימוש דרך MCP:

{
  "name": "run-script",
  "arguments": {
    "script": "Get-Process | Select-Object -First 5 | Format-Table",
    "workingDirectory": "C:\\",
    "timeoutSeconds": 30
  }
}

תצורה

השרת תומך בתצורה באמצעות קובץ config.json:

{
  "Port": 8090,
  "Host": "localhost",
  "MaxConcurrentRequests": 10,
  "TimeoutSeconds": 300,
  "AllowedPaths": [
    "C:\\Scripts\\",
    "C:\\Tools\\"
  ],
  "Security": {
    "EnableScriptValidation": true,
    "BlockDangerousCommands": true,
    "RestrictedCommands": [
      "Remove-Item",
      "Format-Volume",
      "Stop-Computer",
      "Restart-Computer"
    ]
  }
}

אבטחה

• הרצת סקריפטים מתבצעת בתהליכי PowerShell מבודדים
• תמיכה ברשימת פקודות אסורות
• הגבלת זמן הרצה
• רישום כל הפקודות המורצות
• אפשרות להגביל נתיבים זמינים

רישום (לוגים)

• מצב STDIO: הלוגים נכתבים לקובץ %TEMP%\mcp-powershell-server.log
• מצב HTTP: הלוגים מוצגים בקונסולה עם הדגשת צבע

רמות רישום: DEBUG, INFO, WARNING, ERROR

אינטגרציה עם עוזרי AI

Gemini CLI

gemini --mcp-config "path/to/mcp_servers.json" -m gemini-2.5-pro -p "הצג את 5 התהליכים הראשונים במערכת"

לקוחות MCP אחרים

השרת תואם לכל הלקוחות התומכים בפרוטוקול MCP 2024-11-05.

פתרון בעיות

בעיות נפוצות

1. הפורט תפוס: שנה את הפורט בתצורה או עצור את התהליך המשתמש בפורט.
2. הרשאות גישה: הרצה על פורטים מועדפים (<1024) דורשת הרשאות מנהל.
3. קידוד: ודא ש-PowerShell מוגדר ל-UTF-8.
4. גרסת PowerShell: נדרשת גרסה 7 ומעלה של PowerShell.

אבחון

בדוק את הלוגים של השרת לאבחון בעיות:

Get-Content "$env:TEMP\mcp-powershell-server.log" -Tail 20

פיתוח והרחבה

ניתן להרחיב את השרת בקלות עם כלי MCP חדשים. עיין ב-how-to-use.md להוראות פיתוח מפורטות.

רישיון

פרויקט זה מופץ תחת רישיון MIT. עיין בקובץ LICENSE לפרטים.

תמיכה

• פתח Issue במאגר ה-GitHub.
• עיין בתיעוד ב-how-to-use.md.
• עיין בדוגמאות השימוש.

גרסאות

• 1.0.0 – גרסה ראשונית עם תמיכה במצבי STDIO ו-HTTP.