إضافة خادم MCP

يمكن لـ "Gemini في Android Studio" التفاعل مع أدوات خارجية باستخدام بروتوكول سياق النموذج (MCP). توفّر هذه الميزة طريقة موحّدة لكي يستخدم "وضع الوكيل" الأدوات ويوسّع نطاق المعرفة والقدرات من خلال البيئة الخارجية.

هناك العديد من الأدوات التي يمكنك ربطها بمضيف MCP في "استوديو Android". على سبيل المثال، يمكنك الدمج مع خادم MCP على GitHub لإنشاء طلبات سحب مباشرةً من Android Studio أو مع خادم MCP عن بُعد على Figma لتقديم معلومات التصميم بدون تنزيل تطبيق سطح المكتب. للحصول على المزيد من الأفكار، اطّلِع على أمثلة على خوادم MCP.

لإضافة خادم MCP، اتّبِع الخطوات التالية:

  1. انتقِل إلى إعدادات خادم MCP من خلال النقر على ملف (استوديو Android على نظام التشغيل macOS) > الإعدادات > الأدوات > Gemini > خوادم MCP.
  2. اختَر تفعيل خوادم MCP.
  3. أضِف إعدادات MCP في الحقل المتوفّر. يتم حفظ الإعدادات في ملف mcp.json في دليل الإعدادات في "استوديو Android".

في ما يلي مثال على ملف mcp.json:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
    "figmaRemoteMcp": {
      "httpUrl": "https://mcp.figma.com/mcp"
    }
  }
}

راجِع المستندات الخاصة بخادم MCP الذي تريد دمجه للحصول على قيم الإعدادات الدقيقة التي يجب إدراجها في هذا الملف. قد تحتاج أيضًا إلى تثبيت أدوات مثل Node.js أو Docker، وذلك حسب متطلبات برنامج خادم MCP.

الإعدادات

في ما يلي خيارات إعداد خادم MCP الكاملة.

خادم MCP المحلي

يسرد الجدول التالي خيارات الإعداد لتشغيل خادم MCP كعملية خلفية محلية.

الاسم النوع الوصف
command سلسلة مطلوب. الملف التنفيذي أو الأمر المطلوب تشغيله (على سبيل المثال، npx أو ./my-server)
args List<String> اختيارية: قائمة بوسيطات سطر الأوامر التي سيتم تمريرها إلى الملف التنفيذي القيمة التلقائية هي [] (قائمة فارغة).
env Map<String, String> اختيارية: خريطة لمتغيرات البيئة التي سيتم ضبطها للعملية. القيمة التلقائية هي {} (خريطة فارغة).
enabled قيمة منطقية اختيارية: تحديد ما إذا كانت إعدادات الخادم هذه مفعَّلة. القيمة التلقائية هي true.

خادم MCP البعيد

يسرد الجدول التالي خيارات الإعدادات اللازمة للاتصال بخادم MCP من خلال نقل بيانات HTTP قابلة للبث.

الاسم النوع الوصف
httpUrl سلسلة مطلوب. عنوان URL الكامل لنقطة نهاية HTTP التي يمكن بثها (على سبيل المثال، https://server.com/mcp).
headers Map<String, String> خريطة لعناوين HTTP المخصّصة التي سيتم تضمينها في طلب الاتصال. القيمة التلقائية هي {} (خريطة فارغة).
timeout طويل مهلة الاتصال بالملّي ثانية يشير الرقم -1 إلى عدم توفّر مهلة. القيمة التلقائية هي -1.
enabled قيمة منطقية تحديد ما إذا كانت إعدادات الخادم هذه مفعَّلة. القيمة التلقائية هي true.

القيود

لا تتوفّر الوظائف التالية بعد في عملية الدمج مع "منصة MCP" في Android Studio:

  • مراجع MCP
  • نماذج الطلبات
  • عرض الصورة في نافذة المحادثة عندما يستردّ الموظّف الصور باستخدام أدوات مثل get_screenshot