محتويات الدليل
من المحادثة إلى إجراءات المستودع
يربط GitHub MCP Server أدوات الذكاء الاصطناعي بواجهة GitHub وموارد المستودعات التي يملك المستخدم حق الوصول إليها. هذا الربط يجعل قراءة ملفات المشروع والبحث في الشيفرة ومتابعة القضايا وطلبات السحب وسير العمل جزءاً من محادثة واحدة. يستطيع المطور استخدامه لفهم بنية مشروع أو مراجعة تعديل مطروح أو تحديد مواقع ملفات تتعلق بعطل معلوم. ويقدم المشروع وسائل للتعامل مع المعلومات والإجراءات داخل GitHub، مع استمرار خضوع العمليات لصلاحيات الحساب وسياسات المؤسسة. يشكل ذلك امتداداً مفيداً لعمل المساعد داخل محرر الشيفرة، خاصة في المشروعات التي تستند إلى مراجعات الفريق.
جدول المحتويات
المستودعات والقضايا وطلبات السحب
تشرح وثائق GitHub الرسمية حالات استخدام تشمل استعراض المستودعات والبحث في الملفات وفحص الالتزامات وإدارة Issues وPull Requests. يمكن للوكلاء الوصول إلى سياق المشكلة وتفاصيل المراجعة ثم تنفيذ إجراء مخول مثل تحديث قضية أو إنشاء طلب سحب بحسب الأدوات التي فُعلت. تمتد الوظائف إلى متابعة GitHub Actions وتحليل إخفاقات التشغيل وإدارة الإصدارات ضمن مجموعات الأدوات المناسبة. ويؤثر إعداد toolsets في الأدوات المتاحة فعلياً، لذلك قد تختلف قائمة الأوامر التي يراها عميل MCP من اتصال إلى آخر. ينبغي فحص القائمة المعروضة لدى العميل قبل بناء سير عمل يعتمد على اسم أداة محدد.
اتصال مستضاف أم تشغيل محلي
يوفر GitHub خادماً مستضافاً على العنوان الرسمي api.githubcopilot.com/mcp، ويمكن ربطه من عملاء يدعمون الاتصال البعيد عبر HTTP. توضح الوثائق خيار المصادقة عبر OAuth في العملاء المؤهلين أو استخدام Personal Access Token داخل ترويسة Authorization. كما توفر طريقة محلية عبر حاوية Docker الرسمية ghcr.io/github/github-mcp-server، مع خيارات تسجيل الدخول المناسبة لطريقة التشغيل. قد يفضل فريق العمل الاتصال المستضاف لتخفيف عبء تشغيل الخادم، بينما تلائم الحاوية المحلية البيئات التي تحتاج إلى التحكم في عملية الخادم نفسها. كلا الأسلوبين يواصل الاتصال بخدمات GitHub للوصول إلى المستودعات.
ضبط الصلاحيات والوظائف
تحتاج إجراءات GitHub إلى هوية مصادق عليها، وتتبع الأذونات الممنوحة لها والقيود المفروضة على المستودع والمؤسسة. توصي وثائق المشروع بتحديد أقل صلاحيات ممكنة في الرموز الشخصية، واستخدام رموز مختلفة عند الحاجة وفحص مدة صلاحيتها وطريقة تخزينها. ينبغي فصل مهام القراءة والبحث عن المهام القادرة على تغيير المستودع أو إنشاء طلب سحب أو التعامل مع تشغيلات CI. ومن المفيد تحديد مستودع أو مجموعة مستودعات مستهدفة في التعليمات قبل السماح للمساعد بتنفيذ سلسلة إجراءات. تظل المراجعة البشرية للتغييرات الجوهرية خطوة مناسبة حتى مع نجاح المصادقة والاتصال.
سير عمل للفريق
يمكن بدء مهمة عملية بطلب استعراض قضية مفتوحة حول خطأ في الواجهة، ثم البحث عن مواضع الشيفرة المرتبطة بها ومقارنة الالتزامات الأخيرة. بعد الحصول على ملخص قابل للتحقق، يضع المطور خطة إصلاح ويطلب إنشاء مسودة طلب سحب إذا كانت أدوات الكتابة مفعلة وتسمح بها السياسة. ويستطيع الفريق استخدام الخادم للاستفسار عن سبب فشل GitHub Actions أو مراجعة سجل تشغيل محدد. هذه استخدامات تصف نطاق الوظائف المعلنة، ولا تشكل وعداً بنجاح إصلاح آلي أو ضماناً لصحة التغييرات المقترحة. ينبغي أن تمر الشيفرة المعدلة عبر الاختبارات والمراجعة والضوابط المعتادة.
الترخيص والكلفة والتوافق
المشروع الرسمي منشور بترخيص MIT، ويتضمن وثائق تكامل مع عملاء متعددة مثل Codex وClaude وCursor وCopilot وOpenCode. يختلف إعداد كل عميل بحسب قدرته على OAuth أو استخدام ترويسات HTTP أو تشغيل حاوية محلية. إتاحة الشيفرة المصدرية لا تعني أن جميع خدمات GitHub المرتبطة مجانية أو أن حدود API موحدة؛ تحدد خطة GitHub وصلاحيات الحساب وسياسات واجهة البرمجة ما يمكن استخدامه. تفيد مراجعة وثائق الإصدار الجاري وقائمة الأدوات الفعلية بعد الاتصال في تجنب الاعتماد على أسماء أو قدرات تغيرت بين نسخ الخادم، كما ينبغي حماية بيانات المصادقة من التسرب إلى المستودعات.
- الاسم الرسمي
- GitHub MCP Server
- النماذج والمزودون
- محايد للنموذج؛ يستعمله عميل MCP متصل بـ GitHub مع مصادقة ملائمة.
الفائدة العملية
قراءة موارد GitHub وإدارة القضايا وطلبات السحب وفهم سير العمل من داخل عميل ذكاء اصطناعي متصل.
أبرز الوظائف
استعراض المستودعات والملفات والالتزامات والبحث في الشيفرة. إدارة Issues وPull Requests وفق الصلاحيات. متابعة GitHub Actions وسير العمل. تكامل مع GitHub عبر خادم مستضاف أو حاوية محلية. تخصيص مجموعات الأدوات toolsets.
لمن يناسب؟
مطورو البرمجيات، مسؤولو المستودعات، فرق مراجعة الشيفرة وDevOps، ومستخدمو وكلاء البرمجة.
متطلبات التشغيل
حساب GitHub وصلاحية وصول مناسبة؛ عميل MCP يدعم Streamable HTTP للاتصال المستضاف أو Docker لتشغيل الخادم محلياً. المصادقة بالرمز PAT متاحة لمعظم العملاء؛ كما تدعم بعض تطبيقات GitHub Copilot تدفق OAuth. مفتاح API مدفوع مستقل غير مطلوب من الخادم المفتوح المصدر.
التثبيت من المصدر
1. للخادم المستضاف: أضف https://api.githubcopilot.com/mcp/ إلى إعدادات MCP في عميل يدعم HTTP. 2. صادق بواسطة OAuth إذا دعمه العميل، أو أضف PAT بحد أدنى من الأذونات. 3. للتشغيل المحلي: جهز Docker واستخدم الصورة ghcr.io/github/github-mcp-server وفق وثائق GitHub. 4. تحقق من الأدوات والمستودعات المسموح بها.
طريقة التشغيل وأمثلة الاستخدام
1. حدد المستودع والحساب المستهدفين. 2. اطلب البحث عن ملف أو قضية أو طلب سحب. 3. اعرض النتائج والالتزامات ذات الصلة. 4. راجع أي إجراء يغير بيانات GitHub قبل اعتماده.
الاعتماديات والأذونات
تُحدد الأذونات وفق نطاق رمز GitHub Personal Access Token أو تدفق OAuth في العميل المدعوم، وسياسات المستودع والمؤسسة. يعمل الاتصال البعيد عبر Streamable HTTP؛ ويعرض الخادم المحلي Docker اتصال stdio. قد تشمل الأدوات القراءة أو إنشاء القضايا وطلبات السحب وإدارتها بحسب مجموعات الأدوات المفعّلة.
اعتبارات الأمان
احفظ PAT في مدير أسرار أو متغير بيئة، وامنع إضافته للمستودعات، وطبّق أقل صلاحيات ممكنة، وراجع الأفعال التي تنشئ أو تعدل محتوى.
المجانية ورسوم التشغيل
شفرة الخادم بترخيص MIT؛ الاستخدام يخضع لحدود GitHub API وسياسات الحساب والخطة. لا يوجد حد مجاني موحد تضمنه وثائق الخادم.
القيود
يحتاج وصولاً إلى GitHub ومصادقة مناسبة. تختلف مجموعات الأدوات وإمكانات OAuth حسب العميل وسياسات المستودع.
الخبرة المطلوبة
سهل نسبياً للخادم المستضاف؛ متوسط للتشغيل بواسطة Docker وضبط الصلاحيات.
اتصال MCP وأدواته
- وسيلة اتصال MCP
- Streamable HTTP
- عنوان خادم MCP العام
- https://api.githubcopilot.com/mcp/
- مصادقة MCP
- API key
- أدوات MCP المتاحة (سطر لكل أداة)
- get_file_contents: قراءة محتويات ملف أو مجلد داخل مستودع مصرح به (قراءة). search_repositories: البحث عن مستودعات GitHub (قراءة). search_code: البحث في الشيفرة البرمجية ضمن نطاق الوصول (قراءة). list_commits: استعراض سجل الالتزامات في المستودع (قراءة). list_issues: استعراض القضايا المرتبطة بالمستودع (قراءة). issue_read: قراءة تفاصيل قضية وتعليقاتها بحسب الصلاحيات (قراءة). issue_write: إنشاء قضية أو تعديل بياناتها بحسب طريقة الاستدعاء (كتابة). list_pull_requests: استعراض طلبات السحب (قراءة). pull_request_read: الاطلاع على تفاصيل طلب السحب ومحتوياته (قراءة). create_pull_request: إنشاء طلب سحب بين فروع المستودع (كتابة). actions_list: استعراض سير عمل GitHub Actions وتشغيلاته حيث تتوفر مجموعة الأدوات (قراءة؛ قد تعرض الخدمة أسماء قديمة).
- أسماء متغيرات البيئة المطلوبة (بلا قيم)
- GITHUB_PERSONAL_ACCESS_TOKEN
أمر التثبيت الموثق
للعرض والنسخ فقط. راجع الأمر وصلاحياته في مصدر تعليمات التثبيت قبل تنفيذه.
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-serverالتوافق مع وكلاء البرمجة
الحالات التالية توثق ما يعلنه المصدر أو ما سجلته مراجعة مستقلة. لا تعني تجربة تشغيل إلا إذا وُسمت بذلك.
| الوكيل | الحالة | الدليل |
|---|---|---|
| OpenAI Codex | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| Claude Code | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| Cursor | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| GitHub Copilot | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| Gemini CLI | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
| OpenCode | توافق معلن بالمصدر | مصدر التوافق ↗ 2026-10-30 |
لم يوثق المصدر بقية الوكلاء؛ غياب التوثيق لا يعني عدم الدعم.