Gologin MCP Server

官方

用于通过AI对话管理Gologin浏览器配置文件、代理、指纹和Cloud Browser会话的MCP服务器

GitHub
21
试用此 MCP赞助

你可以用 Gologin MCP 做什么？

  • 列出和搜索配置文件 — 通过 get_profile_v2 请求显示 GoLogin 配置文件，支持分页和文件夹筛选。
  • 创建和更新配置文件 — 使用部分设置（如名称、操作系统和代理）请求新配置文件，或修改现有配置文件。
  • 管理代理和指纹 — 为一个或多个配置文件配置代理，并批量刷新其浏览器指纹。
  • 组织文件夹 — 创建文件夹、向文件夹添加或移除配置文件，以及按名称删除文件夹。
  • 控制云会话 — 在云端启动配置文件以获取连接 URL，或停止活动的云会话。
  • 读取账户信息 — 使用 get_user 请求 GoLogin 账户详情。

文档

面向 AI 代理的 GoLogin MCP 服务器

npm version License: MIT

通过 AI 对话管理 GoLogin 浏览器配置文件、代理、指纹、文件夹和云浏览器会话。此模型上下文协议（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

打开 设置 > 开发者 > 编辑配置，并将快速开始配置添加到 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 注册表发布

server.json 在 io.github.gologinapp/gologin-mcp 下描述了此服务器，供 官方 MCP 注册表 使用。npm 包在 mcpName 中声明了相同的标识符。

请保持 package.json、package-lock.json 和 server.json 中的版本一致。先发布已检查的 npm 包，然后从仓库的 Actions 选项卡在 main 上运行 发布到 MCP 注册表。该工作流会验证 npm 版本包含正确的注册表标识符，并使用 GitHub OIDC 进行身份验证，无需单独的注册表令牌。它不会发布到 npm。

链接

许可证

MIT，版权所有 GoLogin。