לכל הפרויקטים
פעילקוד פתוח · 2026

Ports + MCP

כלי macOS ממוקד ושרת MCP לאיתור ופתרון בטוח של התנגשויות פורטים מקומיות.

נקודת המוצא

לאתר איזה תהליך תופס פורט מקומי, ולסגור אותו בבטחה, בדרך כלל דורש הרכבה ידנית של lsof ו-ps — איטי ומועד לטעויות, בעיקר עבור סוכני AI שצריכים לפתור התנגשויות פורטים באופן פרוגרמטי.

Model Context Protocol (stdio)
$npx @ports-mcp/cli
Listening on stdio
Initialized Ports MCP Server
Registered tools: list_ports, inspect_port, kill_process

סקירה כללית

כלי מקומי ל-macOS בלבד לרשימת פורטים פתוחים והתהליכים שמאחוריהם, חשוף גם כשרת MCP בפרוטוקול stdio לסוכני AI וגם כממשק ווב מקומי קטן לשימוש ידני.

הצורך

דיבוג שגיאות “port already in use” במחשב פיתוח בדרך כלל דורש הרצה ידנית של lsof ו-ps, ואז החלטה אם בטוח לסגור את התהליך. סוכני קידוד מבוססי AI נתקלים באותה בעיה בלי דרך בטוחה ומובנית לפתור אותה.

מטרות המוצר

  • לתת לסוכנים ולמפתחים דרך לקריאה בלבד לרשימת פורטים ותהליכים תחילה.
  • להפוך את סגירת התהליך לפעולה מפורשת ומוגנת ולא תופעת לוואי שקטה.

אילוצים

  • macOS בלבד, מתבסס על lsof/ps.
  • מקומי בלבד — לא מיועד לסביבת ייצור או גישה מרוחקת/מרובת משתמשים.
  • פרויקט סולו, בשלב פרוטוטייפ.

הפתרון

שרת MCP שחושף list_ports, find_process_by_port, ו-kill_process_on_port מוגן (dry-run כברירת מחדל, דורש אישור מפורש ומוודא מחדש שה-PID עדיין מחזיק בפורט לפני שליחת האות). נתיב הפעלה מחדש מבוסס shell שרירותי מגרסה קודמת הוסר מטעמי בטיחות.

חוויית המוצר

כלי שורת פקודה / MCP — אין משטח מוצר חזותי מעבר לממשק הווב המקומי הקטן.

התהליך

נבנה סולו ככלי ממוקד; שכבות בטיחות (ברירת מחדל dry-run, אימות PID מחדש) נוספו במכוון לאחר הגרסה הראשונית.

עבודה בעזרת AI

נבנה בעזרת קידוד מבוסס AI, עם תשומת לב מיוחדת שהוקדשה ידנית לחיזוק נתיב ה-kill_process_on_port ההרסני.

מצב נוכחי

פרוטוטייפ — פעיל, בשימוש מקומי, טרם אומץ באופן נרחב.

מה הלאה

אין מפת דרכים מחייבת; יעודכן ככל שתעלה חיכוך סביב התנגשויות פורטים מקומיות.

לקחים שנלמדו

בדיקה לקריאה בלבד קודם, ופעולות הרסניות מוגנות ומפורשות אחר כך — דפוס ששווה להעביר לכלים נוספים הפונים לסוכנים.

מצב עכשווי

מה קיים ועובד כיום
  • ·גרסת הפצה ל-macOS זמינה דרך GitHub Releases.
  • ·ממשק שרת MCP ב-stdio התואם ל-Claude ו-Antigravity.
שאלות פתוחות ואתגרי המשך
  • ·תמיכה בריבוי פלטפורמות לבדיקת תהליכים ב-Linux ו-Windows.

אפשרויות נגישות

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