خادم GitHub MCP: التثبيت والرمز المميّز وتتبع الاستدعاءات

خادم GitHub MCP: التثبيت المحلي أو البعيد بحسب README، ومجموعات الأدوات الدنيا، ووضع القراءة فقط، ورمز مميّز بصلاحيات محدودة، وتتبع الاستدعاءات.
GitHub MCP server : installation, jeton et traçage des appels

خادم GitHub MCP هو خادم MCP الرسمي من GitHub: يتيح لوكيل برمجة قراءة المستودعات وفتح issues والتعليق على pull requests وفحص workflows في Actions، دون المرور بسكربت محلي الصنع. يضم مستودع github/github-mcp-server نحو 33 700 نجمة في منتصف أكتوبر 2026، وهو عادةً أول خادم MCP يربطه الفريق بوكيله.

لهذه السهولة ثمن على صعيد التشغيل. فالوكيل الذي يستطيع الكتابة في مستودعاتك برمز مطوّر مميّز (token) فاعلٌ إضافي في سلسلة التسليم لديك. يتبع هذا الدليل README ووثائق المشروع: تثبيت الخادم، واختيار الأدوات المعروضة، وتقييد صلاحيات الرمز، وحفظ أثر كل استدعاء. وللاطلاع على أساسيات البروتوكول، راجع شرحنا لبروتوكول Model Context Protocol.

توضيح للأمانة: لم تثبّت span.observer هذا البرنامج من أجل هذا المقال. الأوامر مأخوذة من README ووثائق المستودع، واللقطات أدناه مقتطفات معروضة انطلاقًا من هذه الملفات.

خادم GitHub MCP: ما يقوله المستودع

  • الناشر والترخيص: GitHub، بترخيص MIT (ملف LICENSE في المستودع).
  • اللغة: Go؛ ويطلب README الأمر go build لبناء الملف التنفيذي.
  • أرقام قُرئت في 16 أكتوبر 2026 من صفحة المستودع: نحو 33 700 نجمة، ونحو 5 200 تفرّع (fork)، و1 191 إيداعًا (commit) على الفرع الرئيسي. وآخر إصدار معروض هو v2.0.2 بتاريخ 8 أكتوبر.
  • وضعان: خادم محلي (عملية يشغّلها عميل MCP لديك، في Docker أو كملف تنفيذي)، وخادم بعيد تستضيفه GitHub على العنوان https://api.githubcopilot.com/mcp/. ويوضح README أن الوضع البعيد يتطلب VS Code 1.101 أو أحدث لدعم MCP البعيد وOAuth.

الخادم ليس تطبيقًا من Dynatrace ولا يعتمد على أي منتج من Dynatrace. وينطبق جزء قابلية الملاحظة على Dynatrace SaaS وعلى Dynatrace Managed معًا، لأنه يعتمد على OpenTelemetry من جهة الوكيل.

جولة في الإعداد

نقطة الدخول المحلية هي صورة Docker العامة ghcr.io/github/github-mcp-server. يعطي README تصريحها في عميل MCP، مع رمز مميّز يُطلب وقت التنفيذ بدلًا من كتابته في الملف:

مقتطف من README الخاص بـ github-mcp-server: إعداد JSON لعميل MCP يشغّل صورة Docker ghcr.io/github/github-mcp-server مع المتغير GITHUB_PERSONAL_ACCESS_TOKEN المقروء من إدخال مخفي

سطرًا بسطر: يُبقي -i الإدخال القياسي مفتوحًا، وهو ما يتطلبه نقل stdio؛ ويحذف --rm الحاوية عند الانتهاء؛ ويمرّر -e GITHUB_PERSONAL_ACCESS_TOKEN المتغير دون أن يظهر في الأمر؛ ويطلب الإدخال promptString مع "password": true الرمز عند البدء.

التثبيت خطوة بخطوة

الخطوة 1 — اختيار المحلي أو البعيد

يُبقي الوضع المحلي التنفيذ على الجهاز أو خادم البناء، ما يسهّل العزل (راجع عزل خادم MCP بنمط STDIO). ويتجنب الوضع البعيد Docker لكنه ينقل المراقبة إلى جهة العميل، إذ لا توجد عملية لديك لتراقبها.

الخطوة 2 — تثبيت الخادم المحلي

مع تشغيل Docker، تذكر وثائق تثبيت Claude Code هذا الأمر لتصريح الخادم مع رمز مميّز:

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

وبدون Docker، يقترح README البناء من نسخة مستنسخة:

go build -o github-mcp-server ./cmd/github-mcp-server
./github-mcp-server stdio

يقرأ الأمر stdio المتغير GITHUB_PERSONAL_ACCESS_TOKEN من البيئة. تحقق من القائمة بالأمر claude mcp list كما يوصي الدليل. انتبه: وضع الرمز نصًّا صريحًا في الأمر يحفظه في إعداد العميل؛ ففضّل متغير بيئة أو الإدخال المخفي في JSON أعلاه.

الخطوة 3 — تقليص الأدوات المعروضة

بشكل افتراضي يفعّل الخادم مجموعات الأدوات (toolsets) context وrepos وissues وpull_requests وusers. ويسرد README أيضًا، من بين غيرها، actions وcode_security وdependabot وgists وprojects وsecret_protection، وقيمة خاصة هي all. وكل أداة معروضة تستهلك من سياق الوكيل وتوسّع سطح هجومه: فعّل فقط ما تحتاجه المهمة.

مقتطف من README الخاص بـ github-mcp-server: أسطر أوامر بالخيارات --toolsets و--tools و--read-only، وأمر docker run مع المتغيرين GITHUB_PERSONAL_ACCESS_TOKEN وGITHUB_READ_ONLY

يتقدم المتغير GITHUB_TOOLSETS على الخيار --toolsets إذا وُجدا معًا. ولوضع القراءة فقط (--read-only أو GITHUB_READ_ONLY=1) الأولوية: تُتجاهل أدوات الكتابة حتى لو طُلبت بالخيار --tools. ويضيف دليل الإعداد الخيار --exclude-tools الذي يتقدم على كل حالات التضمين.

المصادقة: الرمز بأقل الصلاحيات

على github.com يصف README اتصال OAuth عند أول استخدام، مع حفظ الرمز في الذاكرة فقط. ويتقدم رمز الوصول الشخصي المعرَّف في GITHUB_PERSONAL_ACCESS_TOKEN على OAuth. وبالنسبة إلى الرمز الكلاسيكي، يقترح README كحد أدنى repo وread:packages (الوصول إلى صورة Docker) وread:org (الفرق)، ويدعو إلى منح الصلاحيات التي ترضى بائتمان الوكيل عليها فقط.

مقتطف من docs/scope-filtering.md في github-mcp-server: جدول يقارن ترشيح الأدوات بحسب نوع المصادقة، الرمز الكلاسيكي وOAuth والرمز fine-grained وGitHub App

هذا الجدول مهم للتشغيل: مع رمز كلاسيكي (ghp_) يخفي الخادم عند البدء الأدوات التي لا يملك الرمز نطاقاتها (scopes)؛ أما مع رمز fine-grained أو GitHub App فلا يوجد أي ترشيح وتقوم API نفسها بالرفض. وفي هذه الحالة الثانية يأتي التقييد من الرمز ذاته لا من الخادم.

يحدّ وضع lockdown (--lockdown-mode) المحتوى القادم من المستودعات العامة والمرفوع إلى الوكيل بمن لديهم صلاحية كتابة، لتقليل خطر حقن المُوجّهات (prompt injection). ويصفه README بأنه مرشّح «best-effort» وليس حدًّا للتفويض. ويُفصَّل خطر التعليمات المخفية في issue في مقالنا عن تسميم أدوات MCP، وأفضل الممارسات العامة في تأمين خادم MCP.

تتبع استدعاءات الخادم

لا يصف README أي تصدير للتتبعات أو المقاييس من الخادم نفسه. فتأتي القابلية للتتبع إذن من ثلاثة مصادر.

  • عميل الوكيل. يصدر Claude Code مثلًا عبر OpenTelemetry حدث claude_code.tool_result مع tool_name وsuccess وduration_ms وmcp_server_scope، وينسب الرموز والتكاليف إلى mcp_server.name وmcp_tool.name. ويُوصف الإعداد في مراقبة وكيل برمجة في المؤسسة. ولا تُضمَّن معاملات الأدوات إلا مع OTEL_LOG_TOOL_DETAILS=1: تجنّبه ما لم تتحكم فيما يخرج إلى سجلاتك.
  • اصطلاحات OpenTelemetry الخاصة بـ MCP (حالة Development): span عميل باسم {mcp.method.name} {target}، مثل tools/call get_file_contents، مع mcp.method.name وgen_ai.tool.name. والمنهج في مراقبة وكلاء MCP عبر OpenTelemetry.
  • من جهة GitHub. بحسب README، تعرّف طلبات API في وضع STDIO عن نفسها بالصيغة github-mcp-server/<version> مع اسم عميل MCP وإصداره بين قوسين. ولتمييز عدة نسخ (github.com وخادم GitHub Enterprise Server مثلًا)، يوثّق README المتغيرين GITHUB_MCP_SERVER_NAME وGITHUB_MCP_SERVER_TITLE.

الحدود والنقاط المفتوحة

  • الوكيل المزوَّد بأدوات كتابة يمكنه تعديل المستودعات: وضابط الحماية هو الرمز والقراءة فقط، لا لباقة المُوجّه.
  • محتوى issues وpull requests مدخل غير موثوق؛ ويقلل وضع lockdown الخطر دون إزالته.
  • يتحرك المشروع بسرعة: يلاحظ README أن الوسم v2.0.0 سبق تصحيح مسار وحدة Go ولا يصلح للاستخدام كوحدة. ثبّت إصدار الصورة بدل اتباع الأحدث.
  • أسماء الأدوات ومجموعاتها المذكورة هنا مأخوذة من README في يوم الكتابة؛ تحقق منها بعد كل تحديث.

كيف تتحقق من أنه يعمل

  1. يُظهر claude mcp list الخادم github؛ ويسرد عميلك الأدوات المتوقعة، وهي وحدها.
  2. مع --read-only، اطلب من الوكيل إنشاء issue: يجب أن تكون أداة الكتابة غائبة.
  3. في واجهتك الخلفية لـ OpenTelemetry (Dynatrace SaaS أو Managed أو غيرها) يظهر استدعاء الأداة باسمه ومدته وحالته.

أفضل الممارسات

  • ابدأ بالقراءة فقط مع مجموعتَي الأدوات repos وissues، ثم وسّع عند الحاجة.
  • استخدم رمزًا مخصصًا قصير العمر، وليس أبدًا رمز مسؤول.
  • سجّل استدعاءات الكتابة وراجعها بعد كل حادثة، دون البحث عن مُلام.
  • أبقِ الرمز خارج معاملات الأدوات والتتبعات.

الأسئلة الشائعة

هل أختار الخادم المحلي أم البعيد؟

يمنح المحلي تحكمًا أكبر (عزل وإصدار مثبّت)؛ ويتجنب البعيد Docker لكنه يترك لـ GitHub استضافة الخادم. ويتوقف الاختيار على سياسة التنفيذ لديك.

ما الصلاحيات الدنيا للرمز؟

يقترح README الصلاحيات repo وread:packages وread:org للرمز الكلاسيكي. قلّصها إن لم تستخدم صورة Docker ولا الفرق.

هل يرسل الخادم تتبعات OpenTelemetry بنفسه؟

لا يصف README ذلك. تتبّع من جهة عميل الوكيل، أو راجع دليلنا عن خادم Chrome DevTools MCP وهو خادم آخر من السلسلة نفسها.

الخلاصة

يستحق خادم GitHub MCP العناء: رسمي وبترخيص MIT وموثّق جيدًا. ويُختصر حسن استخدامه في أربعة إعدادات: محلي أو بعيد، ومجموعات أدوات دنيا، ورمز مقيّد، وقراءة فقط افتراضيًا. يبقى تتبع كل استدعاء من جهة العميل لتتمكن من الإجابة عن «من فعل ماذا، ومتى». المصادر: مستودع github/github-mcp-server.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
NVIDIA OpenShell runtime agents IA : isoler et auditer

بيئة تشغيل NVIDIA OpenShell لوكلاء الذكاء الاصطناعي: العزل والتدقيق

Next Post
Chrome DevTools MCP : perf web et débogage par un agent de code

Chrome DevTools MCP: أداء الويب وتصحيح الأخطاء بواسطة وكيل برمجة

Related Posts