新增 MCP 伺服器

Android Studio 中 Gemini 的代理程式可使用模型內容通訊協定 (MCP) 與外部工具互動。這項功能提供標準化方式，讓代理模式使用工具，並透過外部環境擴充知識和功能。

您可以在 Android Studio 中將許多工具連結至 MCP 主機。舉例來說，您可以與 GitHub MCP 伺服器整合，直接從 Android Studio 建立提取要求，也可以與 Figma 遠端 MCP 伺服器整合，不必下載桌面應用程式就能提供設計資訊。如需更多想法，請參閱 MCP 範例伺服器。

如要新增 MCP 伺服器，請按照下列步驟操作：

  1. 依序點選「File」(在 macOS 上為「Android Studio」) >「Settings」>「Tools」>「Gemini」>「MCP Servers」，前往 MCP 伺服器設定。
  2. 選取「啟用 MCP 伺服器」。
  3. 在提供的欄位中新增 MCP 設定。設定會儲存在 Android Studio 設定目錄的 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 伺服器說明文件。您可能也需要安裝 Node.js 或 Docker 等工具，視 MCP 伺服器的軟體需求而定。

設定

以下是完整的 MCP 伺服器設定選項。

本機指令 MCP 伺服器

下表列出啟動 MCP 伺服器做為本機背景程序，並透過標準 I/O 傳輸連線的設定選項。

名稱 類型 說明
command 字串 此為必要項目。要執行的可執行檔或指令 (例如 npx 或 ./my-server)。
args List<String> (選用) 要傳遞至可執行檔的指令列引數清單。預設值為 [] (空白清單)。
env Map<String, String> (選用) 要為程序設定的環境變數對應。預設值為 {} (空白地圖)。
enabled 布林值 (選用) 這項伺服器設定是否有效。預設值為 true。

HTTP MCP 伺服器

下表列出透過可串流 HTTP 傳輸連線至 MCP 伺服器的設定選項。

名稱 類型 說明
httpUrl 字串 此為必要項目。可串流 HTTP 端點的完整網址 (例如 https://example.com/mcp 或 http://localhost:1234/mcp)。
headers Map<String, String> 要在連線要求中加入的自訂 HTTP 標頭對應。 預設值為 {} (空白地圖)。
timeout 長 連線逾時時間，以毫秒為單位。-1 表示沒有逾時。預設值為 -1。
enabled 布林值 這項伺服器設定是否有效。預設值為 true。

限制

Android Studio 的 MCP 整合功能目前不支援下列功能：

  • MCP 資源
  • 提示範本
  • 服務專員使用 get_screenshot 等工具擷取圖片時，即時通訊視窗中顯示的圖片
  • OAuth 登入與部分 MCP 伺服器不相容。