SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体gologin-mcp

gologin-mcp

GoLogin MCP Server 是一个基于 Model Context Protocol（MCP）的服务器，用于通过 AI 对话管理 GoLogin 浏览器配置文件、代理、指纹、文件夹和云端浏览器会话。它将 AI 客户端连接到 GoLogin API，让用户可以用自然语言创建、读取、更新、删除和组织浏览器配置文件，配置代理、刷新指纹、管理文件夹，读取账户信息，以及在 GoLogin 云端启动和停止浏览器配置文件。该服务器通过标准输入输出（stdio）通信，需要 Node.js 22 或更高版本、有效的 GoLogin 账户和 API 令牌。它不提供页面导航、点击、表单填写或本地 Orbita 启动工具，页面自动化需使用单独的浏览器自动化客户端或 GoLogin Agent Browser CLI。

访问官网

工具介绍

GoLogin MCP Server 是一个面向 AI 智能体的 Model Context Protocol（MCP）服务器，用于通过 AI 对话管理 GoLogin 浏览器配置文件、代理、指纹、文件夹和云端浏览器会话。它将 AI 客户端连接到 GoLogin API，使用户能够以自然语言方式操作 GoLogin 的各项功能。

用途

该服务器的主要用途是让 AI 客户端（如 Claude Desktop、Cursor 等支持本地 stdio MCP 服务器的客户端）能够直接管理 GoLogin 账户中的浏览器配置文件及相关资源。用户可以通过对话完成配置文件的增删改查、代理设置、指纹刷新、文件夹管理、账户信息读取以及云端浏览器会话的启动和停止。

主要能力

  • 创建、读取、更新、删除和组织浏览器配置文件。
  • 配置配置文件代理并刷新浏览器指纹。
  • 管理文件夹及其配置文件成员关系。
  • 读取账户信息。
  • 在 GoLogin 云端启动和停止浏览器配置文件。云端启动会返回一个连接 URL。

该服务器不暴露页面导航、点击、表单填写或本地 Orbita 启动工具。如需页面自动化，应使用单独的浏览器自动化客户端或 GoLogin Agent Browser CLI。

使用方式

前置条件

需要 Node.js 22 或更高版本、有效的 GoLogin 账户以及 GoLogin API 令牌。Node.js 22 和 24 LTS 已在 macOS Apple Silicon 上测试。

获取 API 令牌

登录 GoLogin 账户，打开 API & MCP，在 API 选项卡中生成令牌。

配置 MCP 客户端

将以下配置添加到 MCP 客户端中，替换令牌占位符，并合并到现有的 mcpServers 配置中。重启或重新加载客户端的 MCP 连接，然后可以提问：“Show me my GoLogin profiles.”。客户端会自动启动服务器。-y 让 npm 无需交互确认即可安装包。该服务器读取 API_TOKEN；其他 GoLogin CLI 使用的 GOLOGIN_TOKEN 变量在此处不是别名。

终端启动检查

在环境中已设置 API_TOKEN 的情况下，可进行终端启动检查。服务器通过标准输入输出（stdio）通信并等待 MCP 客户端。它本身不会打开浏览器或提供交互式命令提示符。

工具调用

工具名称由 GoLogin OpenAPI 规范中的 HTTP 方法和路径生成，服务器在启动时加载该规范。以下是一部分可用工具，并非固定别名列表。可在 MCP 客户端中查询 tools/list 获取当前名称和输入模式。例如，MCP 客户端可以发送 tools/call 请求来读取配置文件。参数遵循每个工具的输入模式。路径和查询参数以及请求体字段作为顶层参数传递。

示例提示

  • “Show me my GoLogin profiles.”
  • “Create a Linux profile named 'Research'.”
  • “Rename profile PROFILE_ID to 'Research US'.”
  • “Update profile PROFILE_ID to use these proxy settings.”
  • “Refresh the fingerprint for profile PROFILE_ID.”
  • “Create a folder named 'Research' and add profile PROFILE_ID to it.”
  • “Start profile PROFILE_ID in the cloud and give me the connection URL.”
  • “Stop the cloud session for profile PROFILE_ID.”
  • “Show my GoLogin account information.”

各 MCP 客户端设置

  • Claude Desktop：打开 Settings > Developer > Edit Config，将快速开始配置添加到 claude_desktop_config.json。完全退出并重启 Claude Desktop，然后检查 gologin-mcp 及其工具是否可用。
  • Cursor：将快速开始配置添加到用户账户的 ~/.cursor/mcp.json，或项目的 .cursor/mcp.json。重新加载 MCP 连接并启用服务器的工具。包含 API 令牌的配置应避免纳入版本控制。
  • 其他 MCP 客户端：使用支持本地 stdio MCP 服务器的客户端。将命令配置为 npx，参数为 -y 和 gologin-mcp，并在服务器环境中设置 API_TOKEN。配置格式和位置取决于客户端。

适用场景

适用于需要通过 AI 对话批量或便捷管理 GoLogin 浏览器配置文件、代理、指纹和云端会话的用户，尤其是使用 Claude Desktop、Cursor 等支持 MCP 的 AI 客户端的场景。

限制

  • 需要 Node.js 22 或更高版本、有效的 GoLogin 账户和 API 令牌。
  • MCP 进程在本地运行；GoLogin API 请求和云端浏览器会话需要网络访问。
  • 云端可用性和 API 操作取决于账户权限和套餐。
  • 服务器需要访问 docs-download.gologin.com 以加载工具定义。
  • 不提供页面导航、点击、表单填写或本地 Orbita 启动工具。
  • 工具名称不是固定别名，需通过 tools/list 获取当前名称。
  • 本地 MCP 启动本身不会在计算机上启动 Orbita。

故障排除

  • 服务器未连接：检查客户端是否可用 Node.js 和 npx，然后重启其 MCP 连接。服务器还需要访问 docs-download.gologin.com 以加载工具定义。
  • API 返回 401 Unauthorized：检查传递给服务器的 API_TOKEN 及其在 GoLogin 中的有效性。更改后重启连接。
  • 找不到工具名称：刷新工具列表并使用 tools/list 返回的名称；list_profiles 和 start_browser 等名称不是内置别名。
  • 云端启动失败：检查 API 响应和账户的云端访问权限。

发布与注册

该包仅包含构建后的服务器、包元数据、README 和许可证。发布检查会验证此允许列表，确保本地状态、数据库、凭据和开发文件不会作为额外文件包含。npm publish 会自动运行相同的检查。server.json 在官方 MCP Registry 下以 io.github.gologinapp/gologin-mcp 描述此服务器。npm 包在 mcpName 中声明相同的标识符。需保持 package.json、package-lock.json 和 server.json 中的版本一致。先发布经过检查的 npm 包，然后在仓库的 Actions 选项卡中从 main 分支运行 Publish to MCP Registry。该工作流验证 npm 发布包含正确的 Registry 标识符，并使用 GitHub OIDC 进行身份验证，无需单独的 Registry 令牌。它不会发布到 npm。

许可证：MIT，版权归 GoLogin 所有。

同类工具

查看分类