新增 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 伺服器做為本機背景程序的設定選項。

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

遠端 MCP 伺服器

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

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

限制

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

  • MCP 資源
  • 提示範本
  • 服務專員使用 get_screenshot 等工具擷取圖片時,即時通訊視窗中顯示的圖片