שרת ה-MCP ל-git, אומת בריצה חיה על Mac אמיתי.

• כלים

  12, נספרו בריצה חיה

• אישורי גישה

  לא נדרשים

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [6]

• מתחזק

  modelcontextprotocol [1][3]

• הורדות

  129 אלף בשבוע האחרון ב-PyPI [2]

• רישיון

  MIT, במעבר ל-Apache-2.0 [4]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם uvx על גבי stdio, כשהוא מכוון למאגר קוד חד-פעמי אחד באמצעות ‎--repository, השלמנו את לחיצת היד של MCP, קראנו ל-tools/list והרצנו תשע קריאות כלי אמיתיות: חמש קריאות קריאה-בלבד שהצליחו, וארבע שציפינו שייכשלו, ומהן הגיע רוב קטע פתרון התקלות. שום קריאה שלנו לא שינתה את מאגר הקוד. הפעלה שנייה, בלי ‎--repository כלל, הפיקה את השגיאה האחרונה למטה. הפקודה uvx mcp-server-git הפשוטה קרסה על ה-Mac הזה עוד לפני לחיצת היד, ולכן שתי ההפעלות השתמשו ב-uvx --with mcp<2 mcp-server-git, שמקבעת את ה-SDK של MCP ל-Python על גרסה 1.29.0. על ה-Mac רצו Python 3.14.3 ו-uv 0.10.11. השם Node מופיע ברצועה למעלה רק משום שלקוח הבדיקה שלנו הוא תהליך Node; השרת הזה אינו זקוק לו. השרת אינו מדפיס דבר בהפעלה, לא ל-stdout ולא ל-stderr, ולכן מה שמופיע למטה הוא תגובת ה-initialize הגולמית בשורה אחת, בדיוק כפי שהגיעה מהחיבור.

{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","capabilities":{"experimental":{},"tools":{"listChanged":false}},"serverInfo":{"name":"mcp-git","version":"1.29.0"}}}

tools/call git_status {"repo_path": "/private/tmp/mcp-git-demo/demo-repo"}

Repository status:
On branch main
Changes not staged for commit:

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 12 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

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

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": [
        "--with",
        "mcp<2",
        "mcp-server-git",
        "--repository",
        "/Users/yourname/code/your-repo"
      ]
    }
  }
}

claude mcp add git -- uvx --with 'mcp<2' mcp-server-git --repository ~/code/your-repo

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": [
        "--with",
        "mcp<2",
        "mcp-server-git",
        "--repository",
        "/Users/yourname/code/your-repo"
      ]
    }
  }
}

Name        Git
Command     uvx
Arguments   --with mcp<2 mcp-server-git --repository /Users/yourname/code/your-repo

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Git בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם, עם חריג אחד בלתי נמנע שמצוין בשלב הראשון. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

1. 01

   התקינו את Routines, ואת uv

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו. השרת הזה כתוב ב-Python, ולכן הוא זקוק גם ל-uv, הכלי שמספק את הפקודה uvx. התקינו אותו מ-astral.sh/uv, או בשורת טרמינל אחת אם כבר יש לכם Homebrew: brew install uv.

2. 02

   פתחו את הגדרות ה-MCP

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

3. 03

   בחרו Command (stdio)‎

   הטופס נפתח במצב URL. העבירו אותו ל-Command (stdio): השרת הזה הוא פקודה שרצה על ה-Mac שלכם, לא כתובת אינטרנט.

4. 04

   כוונו אותו למאגר קוד אחד

   Name: Git. Command: uvx. Arguments: ‎--with mcp<2 mcp-server-git --repository, אחריו רווח והנתיב המלא של תיקיית מאגר הקוד, למשל ‎/Users/yourname/code/your-repo. כתבו את הנתיב במלואו, מתחיל ב-/Users, בלי רווחים.

5. 05

   בדקו, ואז הוסיפו

   השאירו את Environment Variables ריק, השרת הזה לא צריך משתנים. לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שנים עשר עבור השרת הזה. אחר כך לחצו Add Server.

6. 06

   השתמשו בו

   הכלים עובדים בצ׳אט מיד, כך שאפשר לשאול מה השתנה במאגר הקוד השבוע. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

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

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

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

  File "/Users/[REDACTED]/.cache/uv/archive-v0/OwIFwgGFXK4fyeBJ7kmJc/lib/python3.14/site-packages/mcp_server_git/server.py", line 321, in serve
    @server.list_tools()
     ^^^^^^^^^^^^^^^^^
AttributeError: 'Server' object has no attribute 'list_tools'

Repository path '/private/tmp' is outside the allowed repository '/private/tmp/mcp-git-demo/demo-repo'

Ref 'no-such-branch' did not resolve to an object

/private/tmp/mcp-git-demo

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

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

1. [1]

   PyPI registry: mcp-server-gitנקרא בתאריך 2026-08-03

   Latest version 2026.7.10, published 2026-07-10; author Anthropic, PBC.; declares mcp>=1.0.0.

2. [2]

   PyPI download stats: mcp-server-gitנקרא בתאריך 2026-08-03

   128,807 downloads in the last week and 758,320 in the last month at access time.

3. [3]

   GitHub: modelcontextprotocol/serversנקרא בתאריך 2026-08-03

   89,142 stars and a push dated 2026-08-03 at access time, per the GitHub API.

4. [4]

   modelcontextprotocol/servers LICENSE fileנקרא בתאריך 2026-08-03

   The project states it is transitioning from the MIT License to Apache-2.0; docs are CC-BY-4.0. The package metadata still declares MIT.

5. [5]

   Git server README (src/git)נקרא בתאריך 2026-08-03

6. [6]

   Git server source: server.pyנקרא בתאריך 2026-08-03

   Creates Server("mcp-git") with no version and runs stdio_server(): the server speaks stdio and declares no version of its own.

7. [7]

   PyPI registry: mcp (the Python MCP SDK)נקרא בתאריך 2026-08-03

   mcp 2.0.0 was published on 2026-07-28, the release that breaks mcp-server-git 2026.7.10.

8. [8]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   The Claude Desktop config file path and the mcpServers command and args shape.

9. [9]

   Claude Code docs: MCPנקרא בתאריך 2026-08-03

   The claude mcp add [options] <name> -- <command> [args...] syntax for local stdio servers.

10. [10]

    Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

    The mcp.json shape and file locations.

11. [11]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Git כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.