Gologin MCP Server

官方

用於透過AI對話管理Gologin瀏覽器設定檔、代理、指紋及Cloud Browser工作階段的MCP伺服器

GitHub
21
試用此 MCP贊助

你可以用 Gologin MCP 做什麼？

  • 列出與搜尋設定檔 — 要求顯示 GoLogin 設定檔，支援分頁與資料夾篩選，透過 get_profile_v2 達成。
  • 建立與更新設定檔 — 使用部分設定（如名稱、作業系統與代理）請求新設定檔，或修改現有設定檔。
  • 管理代理與指紋 — 為一個或多個設定檔設定代理，並批次重新整理其瀏覽器指紋。
  • 整理資料夾 — 建立資料夾、將設定檔加入或移出資料夾，以及依名稱刪除資料夾。
  • 控制雲端工作階段 — 在雲端啟動設定檔以取得連線 URL，或停止進行中的雲端工作階段。
  • 讀取帳戶資訊 — 使用 get_user 要求 GoLogin 帳戶詳細資料。

文件

適用於 AI 代理的 GoLogin MCP 伺服器

npm version License: MIT

透過 AI 對話管理 GoLogin 瀏覽器設定檔、代理、指紋、資料夾及雲端瀏覽器工作階段。此 Model Context Protocol (MCP) 伺服器可將您的 AI 用戶端連線至 GoLogin API。

快速入門

您需要 Node.js 22 或更新版本、有效的 GoLogin 帳戶，以及 GoLogin API 權杖。Node.js 22 和 24 LTS 已在 macOS Apple Silicon 上測試通過。

  1. 登入您的 GoLogin 帳戶，開啟 API & MCP，然後在 API 分頁中產生權杖。
  2. 將此設定新增至您的 MCP 用戶端，並取代權杖佔位符。將其合併至任何現有的 mcpServers 設定中。
{
  "mcpServers": {
    "gologin-mcp": {
      "command": "npx",
      "args": ["-y", "gologin-mcp"],
      "env": {
        "API_TOKEN": "your-gologin-api-token-here"
      }
    }
  }
}
  1. 重新啟動或重新載入用戶端的 MCP 連線，然後詢問：「顯示我的 GoLogin 設定檔。」

用戶端會自動啟動伺服器。-y 可讓 npm 在無需互動式確認的情況下安裝套件。此伺服器會讀取 API_TOKEN；其他 GoLogin CLI 使用的 GOLOGIN_TOKEN 變數在此處並非別名。

如需在終端機中進行啟動檢查，請先在環境中設定 API_TOKEN：

npx -y gologin-mcp

伺服器透過標準輸入/輸出 (stdio) 進行通訊，並等待 MCP 用戶端連線。它不會自行開啟瀏覽器或提供互動式命令提示字元。

您可以執行的操作

  • 建立、讀取、更新、刪除及整理瀏覽器設定檔。
  • 設定設定檔代理並重新整理瀏覽器指紋。
  • 管理資料夾及其設定檔成員資格。
  • 讀取帳戶資訊。
  • 在 GoLogin 雲端中啟動和停止瀏覽器設定檔。

雲端啟動會傳回連線 URL。此伺服器不提供頁面導覽、點擊、表單填寫或本機 Orbita 啟動工具。如需頁面自動化，請使用獨立的瀏覽器自動化用戶端或 GoLogin Agent Browser CLI。

MCP 程序在本機執行；GoLogin API 要求和雲端瀏覽器工作階段需要網路存取。雲端可用性和 API 操作取決於您的帳戶權限和方案。

工具

工具名稱是根據 GoLogin OpenAPI 規格 中的 HTTP 方法和路徑產生，伺服器會在啟動時載入該規格。以下是可用工具的選集，並非固定的別名清單。請在您的 MCP 用戶端中查詢 tools/list 以取得目前的名稱和輸入結構描述。

工具說明
get_profile_v2列出和搜尋設定檔，支援分頁和資料夾篩選
post_profile_custom使用部分設定（如名稱、作業系統和代理）建立設定檔
get_profile_id依 ID 讀取設定檔
put_profile_id_custom更新選定的設定檔設定
delete_profile刪除 profilesToDelete 中列出的設定檔
patch_profile_proxy_many_v2為一個或多個設定檔設定代理
patch_profile_fingerprints重新整理 browsersIds 中列出的設定檔的指紋
get_proxy_v2列出代理
get_folders列出資料夾
post_folders_folder依名稱建立資料夾
patch_folders_folder在資料夾中新增或移除設定檔
delete_folders_folder依名稱刪除資料夾
post_profile_id_web在雲端啟動設定檔並傳回連線 URL
delete_profile_id_web停止雲端設定檔
get_user讀取帳戶資訊

例如，MCP 用戶端可以傳送此 tools/call 要求來讀取設定檔：

{
  "name": "get_profile_id",
  "arguments": {
    "id": "your-profile-id"
  }
}

引數會遵循每個工具的輸入結構描述。路徑和查詢參數以及要求主體欄位會作為頂層引數傳遞。

範例提示

  • 「顯示我的 GoLogin 設定檔。」
  • 「建立名為『Research』的 Linux 設定檔。」
  • 「將設定檔 PROFILE_ID 重新命名為『Research US』。」
  • 「更新設定檔 PROFILE_ID 以使用這些代理設定。」
  • 「重新整理設定檔 PROFILE_ID 的指紋。」
  • 「建立名為『Research』的資料夾，並將設定檔 PROFILE_ID 新增至其中。」
  • 「在雲端啟動設定檔 PROFILE_ID，並給我連線 URL。」
  • 「停止設定檔 PROFILE_ID 的雲端工作階段。」
  • 「顯示我的 GoLogin 帳戶資訊。」

MCP 用戶端設定

Claude Desktop

開啟 Settings > Developer > Edit Config，並將快速入門設定新增至 claude_desktop_config.json。完全結束並重新啟動 Claude Desktop，然後檢查 gologin-mcp 及其工具是否可用。

請參閱官方本機 MCP 設定指南以了解設定路徑和疑難排解。

Cursor

將快速入門設定新增至您使用者帳戶的 ~/.cursor/mcp.json，或專案的 .cursor/mcp.json。重新載入 MCP 連線並啟用伺服器的工具。請勿將包含 API 權杖的設定納入版本控制。

請參閱 Cursor 的 MCP 文件以了解目前的用戶端設定。

其他 MCP 用戶端

使用支援本機 stdio MCP 伺服器的用戶端。將 npx 設定為命令，-y 和 gologin-mcp 設定為其引數，並在伺服器環境中設定 API_TOKEN。設定格式和位置取決於用戶端。

疑難排解

  • 伺服器無法連線： 檢查 Node.js 和 npx 是否可供用戶端使用，然後重新啟動其 MCP 連線。伺服器也需要存取 docs-download.gologin.com 才能載入其工具定義。
  • API 傳回 401 Unauthorized： 檢查傳遞給伺服器的 API_TOKEN 以及權杖在 GoLogin 中的有效性。變更後請重新啟動連線。
  • 找不到工具名稱： 重新整理工具清單，並使用 tools/list 傳回的名稱；諸如 list_profiles 和 start_browser 等名稱並非內建別名。
  • 雲端啟動失敗： 檢查 API 回應和您帳戶的雲端存取權限。本機 MCP 啟動本身不會在您的電腦上啟動 Orbita。

開發

git clone https://github.com/gologinapp/gologin-mcp.git
cd gologin-mcp
npm ci
npm run build

若要使用已設定的 API_TOKEN 執行您的本機建置：

node dist/index.js

發佈前，請執行：

npm run release:check

套件僅包含建置後的伺服器、套件中繼資料、README 和授權。發佈檢查會驗證此允許清單，確保本機狀態、資料庫、憑證和開發檔案不會作為額外檔案包含在內。npm publish 會自動執行相同的檢查。

MCP Registry 發佈

server.json 在 io.github.gologinapp/gologin-mcp 下描述此伺服器，供官方 MCP Registry 使用。npm 套件在 mcpName 中宣告相同的識別碼。

請保持 package.json、package-lock.json 和 server.json 中的版本一致。先發佈已檢查的 npm 套件，然後從儲存庫的 Actions 分頁在 main 上執行 Publish to MCP Registry。工作流程會驗證 npm 發佈包含正確的 Registry 識別碼，並使用 GitHub OIDC 進行驗證，無需單獨的 Registry 權杖。它不會發佈至 npm。

連結

授權

MIT，版權所有 GoLogin。