/ الدليل / الملعب / GitMCP
● مجتمع idosal ⚡ فوري

GitMCP

بواسطة idosal · idosal/git-mcp

حوّل أي مستودع عام على GitHub إلى نقطة نهاية MCP مباشرة — اسحب ملف README والكود والتوثيق إلى Claude دون استنساخ أو اختلاق APIs.

يستضيف GitMCP خادم MCP عن بُعد على gitmcp.io/{owner}/{repo}. يحصل Claude على أدوات لجلب التوثيق والبحث في المستودع وسرد الملفات وقراءة مسارات بعينها — دائمًا من الفرع الرئيسي الحالي. يقضي على فئة الأخطاء من قبيل «اخترع Claude دالةً غير موجودة» عند استخدام مكتبات غير مألوفة.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

git-mcp-idosal.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "git-mcp-idosal",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "git-mcp-idosal": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://gitmcp.io/{owner}/{repo}"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add git-mcp-idosal -- npx -y mcp-remote https://gitmcp.io/{owner}/{repo}

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: GitMCP

كيف توقف Claude عن اختلاق واجهات برمجية لمكتبة يعرفها نصف معرفة

👤 المطورون الذين يستخدمون مكتبات حديثة (ما بعد تاريخ القطع) أو SDKs متخصصة ⏱ ~15 min beginner

متى تستخدمه: أنت تدمج مكتبة وClaude يستمر في اختراع أسماء دوال غير موجودة.

المتطلبات الأساسية
  • معرفة مسار المكتبة على GitHub — مثلًا pydantic/pydantic-ai — الصق owner/repo في gitmcp.io
الخطوات
  1. أضف GitMCP موجَّهًا نحو المكتبة
    أضف خادم GitMCP لـ pydantic/pydantic-ai إلى إعداداتي، ثم أدرج ملفات التوثيق على المستوى الأعلى.✓ تم النسخ
    → تُعيد الأداة README.md وشجرة /docs — بلا مسارات ملفقة
  2. استفسر من المصدر الحقيقي
    باستخدام GitMCP لـ pydantic-ai، أرني توقيع المنشئ الفعلي لـ Agent — اقتبسه من المصدر مباشرةً، لا تلخص.✓ تم النسخ
    → التوقيع الدقيق مع اسم الملف المصدر ورقم السطر
  3. تحقق بتشغيل المثال
    اكتب مثالًا قابلًا للتشغيل بالحد الأدنى مستخدمًا فقط ما رأيته في المستودع. إن كان شيء ناقصًا فأخبرني — لا تخمّن.✓ تم النسخ
    → المثال يُكمّل التجميع؛ يُشير Claude إلى أي نقص

النتيجة: تكامل فعلي يتطابق مع API المكتبة الحقيقية، لا قصة معقولة الصياغة.

المزالق
  • المكتبة في دليل فرعي ضمن monorepo — استخدم أداة tree أولًا للعثور على جذر الحزمة الصحيح قبل القراءة
اجمعها مع: context7 · github

تدقيق سريع لمستودع مفتوح المصدر غير مألوف قبل التفرع

👤 المهندسون الذين يقيّمون الاعتمادات ⏱ ~10 min beginner

متى تستخدمه: أنت على وشك تبني مكتبة وتريد معرفة ما ستُقدم عليه دون استنساخها.

الخطوات
  1. نظرة عامة
    استخدم GitMCP لـ owner/repo. لخّص البنية من README والمجلدات الرئيسية في 8 أسطر.✓ تم النسخ
    → ملخص مرتبط بأدلة محددة، لا كلام تسويقي فضفاض
  2. فحص المخاطر
    اجلب ملف البيانات الوصفية وأدرج كل اعتماد. أشر إلى أي منها يبدو متروكًا أو له سجل CVE معروف.✓ تم النسخ
    → جدول الاعتمادات مع تقييم لكل عنصر
  3. فحص الملاءمة
    هل ثمة API للإضافات/الامتدادات يمكنني الاستفادة منه، أم سأضطر إلى التفرع؟ استشهد بالكود.✓ تم النسخ
    → إجابة مدعومة بالكود مع مسارات الملفات

النتيجة: قرار تفرع/تبنٍّ/تجاهل في 5 دقائق مستند إلى محتوى المستودع الفعلي.

المزالق
  • مستودع خاص بلا رمز مميز — استخدم صورة Docker المستضافة ذاتيًا واضبط GITHUB_TOKEN
اجمعها مع: github

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

git-mcp-idosal + context7

طبقتان من التوثيق المحدَّث — Context7 لوثائق SDK الرسمية، وGitMCP لمصدر المستودع

قارن ما يقوله context7 عن Foo.bar() مع المصدر الفعلي عبر GitMCP. هل ثمة تباين؟✓ تم النسخ
git-mcp-idosal + github

GitMCP للقراءة فقط، وGitHub MCP لإنشاء PRs والمشكلات

اقرأ دليل المساهمة عبر GitMCP، ثم افتح PR منظمًا جيدًا عبر GitHub MCP.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
fetch_documentation owner, repo أول استدعاء عند استكشاف مستودع غير مألوف 1 GitHub API call
search_documentation owner, repo, query: str ابحث في أقسام التوثيق التي تذكر مفهومًا بعينه 1 API call
fetch_url_content url: str اجلب ملفًا محددًا عبر عنوان URL الخام free
search_code owner, repo, query: str ابحث عن مكان تعريف رمز أو استخدامه 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
GitHub بدون مصادقة: 60 طلبًا/ساعة لكل IP. بمصادقة: 5000 طلب/ساعة.
الرموز لكل استدعاء
500–5000 بحسب الملف
التكلفة المالية
مجاني (مستضاف)
نصيحة
استخدم أدوات search_* بدلًا من تفريغ الملفات كاملة

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: public_repo (for private access)
تخزين بيانات الاعتماد: الرمز المميز كمتغير بيئة في وضع الاستضافة الذاتية
نقل البيانات الخارجي: gitmcp.io (مستضاف) أو نسختك الخاصة
لا تمنح أبدًا: repo:write

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

تجاوز حد المعدل 403

استضف ذاتيًا بـ PAT، أو انتظر — حد غير المصادق 60 طلبًا/ساعة

تحقق: Check X-RateLimit-Remaining header
المستودع غير موجود

تحقق من تهجئة owner/repo وكونه عامًا. للخاص، استخدم صورة الاستضافة الذاتية.

يُعيد محتوى مقطوعًا

GitHub API يحدّ البلوب الخام بـ 1MB. استخدم search_code للملفات الكبيرة.

البدائل

GitMCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Context7تريد سطح وثائق مكتبة منقحًا بدلًا من مستودع خامContext7 يُفهرس مجموعة فرعية فقط؛ GitMCP يغطي أي مستودع عام
GitHub MCP (official)تحتاج إلى عمليات PR/issue/كتابة أيضًاGitHub MCP قادر على الكتابة (يستلزم ضبطًا أكثر)؛ GitMCP للقراءة فقط

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills