یک سرور MCP اضافه کنید

Gemini در عامل اندروید استودیو می‌تواند با استفاده از پروتکل Model Context (MCP) با ابزارهای خارجی تعامل داشته باشد. این ویژگی روشی استاندارد برای حالت عامل فراهم می‌کند تا از ابزارها استفاده کند و دانش و قابلیت‌ها را با محیط خارجی گسترش دهد.

ابزارهای زیادی وجود دارد که می‌توانید در اندروید استودیو به MCP Host متصل شوید. برای مثال، می‌توانید با GitHub MCP Server ادغام شوید تا مستقیماً از اندروید استودیو درخواست‌های pull ایجاد کنید یا با سرور MCP از راه دور Figma ادغام شوید تا اطلاعات طراحی را بدون دانلود برنامه دسکتاپ ارائه دهید. برای ایده‌های بیشتر، به سرورهای نمونه MCP مراجعه کنید.

برای اضافه کردن سرور MCP، مراحل زیر را دنبال کنید:

  1. با کلیک روی File ( اندروید استودیو در macOS) > Settings > Tools > Gemini > MCP Servers به ​​تنظیمات سرور MCP بروید.
  2. فعال کردن سرورهای MCP را انتخاب کنید.
  3. پیکربندی MCP را در فیلد ارائه شده اضافه کنید. این پیکربندی در فایل mcp.json در دایرکتوری پیکربندی اندروید استودیو ذخیره می‌شود.

در اینجا یک نمونه فایل 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 که با آن ادغام می‌شوید مراجعه کنید. همچنین ممکن است بسته به نیازهای نرم‌افزاری سرور MCP، نیاز به نصب ابزارهایی مانند Node.js یا Docker داشته باشید.

پیکربندی‌ها

در اینجا گزینه‌های کامل پیکربندی سرور MCP آورده شده است.

سرور MCP فرماندهی محلی

جدول زیر گزینه‌های پیکربندی برای راه‌اندازی یک سرور MCP به عنوان یک فرآیند پس‌زمینه محلی و اتصال از طریق یک انتقال ورودی/خروجی استاندارد را فهرست می‌کند.

نام نوع توضیحات
command رشته الزامی. فایل اجرایی یا دستوری که باید اجرا شود (برای مثال، npx یا ./my-server ).
args لیست<رشته> اختیاری. فهرستی از آرگومان‌های خط فرمان برای ارسال به فایل اجرایی. مقدار پیش‌فرض [] (یک فهرست خالی) است.
env نقشه<رشته، رشته> اختیاری. نقشه‌ای از متغیرهای محیطی که باید برای فرآیند تنظیم شوند. مقدار پیش‌فرض {} (یک نقشه خالی) است.
enabled بولی اختیاری. فعال بودن یا نبودن این پیکربندی سرور. مقدار پیش‌فرض true است.

سرور HTTP MCP

جدول زیر گزینه‌های پیکربندی برای اتصال به سرور MCP از طریق انتقال HTTP قابل پخش را فهرست می‌کند.

نام نوع توضیحات
httpUrl رشته الزامی. آدرس اینترنتی کامل نقطه پایانی HTTP قابل پخش (برای مثال، https://example.com/mcp یا http://localhost:1234/mcp ).
headers نقشه<رشته، رشته> نقشه‌ای از هدرهای HTTP سفارشی برای درج در درخواست اتصال. مقدار پیش‌فرض {} (یک نقشه خالی) است.
timeout بلند زمان اتصال بر حسب میلی ثانیه. -1 نشان دهنده عدم زمان اتصال است. مقدار پیش‌فرض -1 است.
enabled بولی آیا این پیکربندی سرور فعال است یا خیر. مقدار پیش‌فرض true است.

محدودیت‌ها

قابلیت‌های زیر هنوز توسط ادغام MCP اندروید استودیو پشتیبانی نمی‌شوند:

  • منابع MCP
  • قالب‌های اعلان
  • رندر تصویر در پنجره چت هنگامی که عامل تصاویر را با استفاده از ابزارهایی مانند get_screenshot بازیابی می‌کند
  • ورود به سیستم OAuth با برخی از سرورهای MCP سازگار نیست.