כלים

chatgpt-mcp

מחבר עוזר AI לקבצים, פקודות ופעולות שולחן עבודה מורשות במחשב Linux.

הגדרה בעזרת סוכןלפרויקט

איזו בעיה הכלי פותר

העוזר לא יכול לבדוק קבצים מקומיים או להריץ פקודות פרויקט בלי חיבור למחשב. chatgpt-mcp מספק את החיבור דרך כלים שמוגדרים במפורש, במקום להעתיק שוב ושוב קבצים, פלט מסוף וצילומי מסך.

דרכים להשתמש בכלי

  • לבדוק פרויקט מקומי ולהריץ בדיקות

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

  • לסקור ממשק בשולחן עבודה זמני

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

לפני שמתחילים

  • מחשב Linux או מכונה וירטואלית זמנית, Node.js מגרסה 22, Git ו-pnpm 11.20.0 שנקבע בפרויקט.
  • לקוח MCP; במסלול המנהרה הפרטית של ChatGPT נדרשים מזהה מנהרה משלך, מפתח שמוזן מקומית ושירותי משתמש של systemd עבור המתקין.
  • רק שורשי הקבצים, הפקודות ויכולות שולחן העבודה שבכוונתך לאפשר. פעולות X11 דורשות ציון תצוגה מפורשת.

התקנה והגדרה

  1. לבדוק מי מנהל את השירות הקיים

    מזהים קודם התקנת MCP קיימת או התקנה שמנוהלת ב-Overdeck. לא דורסים הגדרות ולא מתקינים שירות מתחרה. המתקין המהיר מעניק שליטה רחבה; בוחרים הגדרה ידנית לחיבור ראשון עם מעט הרשאות.

  2. לבנות את השרת הציבורי

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

    git clone https://github.com/alexcodeplace/chatgpt-mcp.git
cd chatgpt-mcp
corepack pnpm@11.20.0 install
corepack pnpm@11.20.0 gate

  3. להתחיל רק עם system.info

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

    cp config.example.json config.local.json
CHATGPT_MCP_CONFIG="$PWD/config.local.json" node dist/src/stdio.js

  4. להוסיף חיבור ChatGPT רק כשנדרש

    פועלים לפי מדריך Secure MCP Tunnel ב-README ולפי ההוראות הרשמיות העדכניות של OpenAI. מזינים מפתחות מקומית, משאירים את השרת ב-loopback ובודקים הרשאות רחבות לפני שימוש ב-./install.sh. לא מדביקים מפתח בבקשת הסוכן.

שימוש בפרויקט

  1. לאמת זהות לפני מתן גישה

    בלקוח המחובר מבקשים system.info ובודקים את המחשב ואת היכולות הפעילות. בנייה מוצלחת לבדה אינה מוכיחה שהלקוח מחובר.

    Use system.info to report the connected host and enabled capabilities.

  2. לנסות קריאה מורשית ואז פקודה מוגבלת

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

  3. לבדוק את החיבור בלי לחשוף סודות

    בהתקנה שנוצרה באמצעות מתקין המנהרה משתמשים בפקודת מצב הפרופיל השמור. ב-HTTP ידני בודקים /healthz בפורט המקומי שנבחר. מעדכנים דרך תהליך הפריסה שמנהל את ההתקנה.

    ./scripts/tunnel-status.sh

איך יודעים שזה עובד

הלקוח מציג רק את הכלים שהופעלו ו-system.info מזהה את מחשב ה-Linux הנכון. קריאת תיקייה מורשית עובדת בלי הרחבת הרשאות, ופעולות חסומות נשארות חסומות.

לבקש מהסוכן להגדיר את הכלי

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

אפשר גם לבחור את הטקסט ולהעתיק אותו ישירות.

מה כדאי לדעת מראש

גישה למחשב היא הרשאה רחבה. מומלץ להשתמש במכונה וירטואלית זמנית ולאפשר רק את היכולות הנדרשות.

README העדכני של הפרויקט

סוכניםאוטומציהחיבורים