如何从官方MCP注册表安装CapSolver MCP

简要总结

• CapSolver MCP 在官方 MCP 注册表中列为 io.github.capsolver-ai/capsolver-mcp。 当前最新版本为 0.1.3，通过 PyPI 分发并通过 stdio 本地启动。
• 最短安装路径为 uvx capsolver-mcp。 uvx 会创建一个隔离环境并运行已发布的命令，无需永久全局安装包。
• 每个客户端配置都需要 CAPSOLVER_API_KEY。 将真实密钥保存在客户端环境或受批准的密钥存储中，永远不要放在公共仓库中。
• 工作连接应暴露五个工具。 它们涵盖基于令牌的求解、页面检测、页面级求解、余额检查和受支持的挑战类型。
• 基于浏览器的工具需要可选的 browser 附加组件和 Playwright Chromium。 基础基于令牌的工具不需要额外的浏览器安装。
• 仅在您拥有或被授权测试或自动化的流程中使用 CapSolver。 注册表的可用性不意味着可以访问私有或受限系统。

从官方 MCP 注册表安装 CapSolver MCP

官方 MCP 注册表为 MCP 客户端和开发者提供了一个规范的记录，用于发现 CapSolver MCP、其包、传输方式、所需环境变量、仓库和当前版本。注册表不托管 Python 包，而是将客户端指向 PyPI 上的已验证 capsolver-mcp 发布版本。

本教程将介绍发现、安装、配置和首次连接检查。它仅用于合法、授权的 AI 代理、QA、RPA 和浏览器自动化流程。

官方注册表条目提供的内容

CapSolver MCP 条目发布了兼容客户端需要构建本地 stdio 配置的精确元数据。

您可以在 官方 MCP 注册表搜索界面 中查看当前条目。注册表是一个上游目录：它标准化了发现元数据，而实际包仍位于 PyPI。MCP 注册表发布文档 描述了此目录和分发模型。

前提条件

CapSolver MCP 需要 Python 3.10 或更高版本、兼容的 MCP 客户端和 CapSolver API 密钥。

在编辑客户端配置之前，请准备以下内容：

1. 安装 Python 3.10 或更高版本。
2. 如果您想使用推荐的 uvx 工作流，请安装 uv。
3. 创建 CapSolver 账户并从仪表板获取 API 密钥。
4. 确认您的 MCP 客户端支持本地 stdio 服务器。
5. 决定是否只需要基于令牌的工具或可选的浏览器工具。

CapSolver MCP 服务文档 解释了支持的集成路径，而 CapSolver AI 代理概述 帮助您在 MCP、代理工具和 Core SDK 之间进行选择。

步骤 1：查找正确的注册表记录

在官方 MCP 注册表中搜索 capsolver 并选择此精确名称：

io.github.capsolver-ai/capsolver-mcp

确认显示的版本是 0.1.3 或更高版本，并且状态为活动。除非您已单独审查了发布者、仓库、权限和源代码，否则请避免使用类似名称的社区包。

对于 API 级别的检查，请求精确的服务器版本：

curl "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.capsolver-ai%2Fcapsolver-mcp/versions/0.1.3"

注册表名称中的斜杠编码为 %2F。响应应将 capsolver-mcp 标识为 PyPI 包，uvx 作为运行时提示，stdio 作为传输方式。

步骤 2：安装并验证 CLI

推荐路径是在隔离环境中运行 CapSolver MCP：

uvx capsolver-mcp --help

如果您更喜欢管理的虚拟环境，请显式安装包：

python -m pip install "capsolver-mcp==0.1.3"
capsolver-mcp --help

当前 CLI 支持 stdio、sse 和 streamable-http 运行时模式。官方 MCP 注册表条目使用 stdio，因为客户端将本地包作为子进程启动。该包也可以在您自己的基础设施上启动一个支持 HTTP 的进程，但 CapSolver 当前不在注册表中发布托管的远程 MCP 端点。

uvx 方法遵循 官方 uv 工具指南 中记录的隔离工具执行模型。

领取您的 CapSolver 奖励代码

立即提升您的自动化预算！
在充值 CapSolver 账户时使用奖励代码 CAP26，每次充值可获得额外 5% 奖励——无限制。
现在在您的 CapSolver 仪表板 中领取

步骤 3：配置本地 MCP 客户端

本地客户端必须启动 uvx capsolver-mcp 并将 CAPSOLVER_API_KEY 传递给子进程。

在接受 mcpServers 对象的客户端中使用此配置格式，包括 Claude 桌面和具有兼容本地服务器配置的客户端：

{
  "mcpServers": {
    "capsolver": {
      "command": "uvx",
      "args": ["capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

本地替换占位符。不要将真实 API 密钥提交到 Git、粘贴到问题报告中或包含在截图中。

如果桌面应用程序找不到 uvx，请使用以下命令返回的绝对路径：

which uvx

在 Windows PowerShell 中使用：

Get-Command uvx

保存配置后，完全重启 MCP 客户端。窗口关闭可能使应用程序在后台运行，因此在编辑配置后如果服务器未出现，请退出进程。

步骤 4：验证 MCP 握手和工具

成功的连接应向客户端暴露五个 CapSolver MCP 工具。

从非浏览器检查开始，例如：

使用 CapSolver MCP 服务器列出支持的 CAPTCHA 类型。

然后通过以下方式验证账户认证：

使用 CapSolver MCP 服务器检查我的账户余额。

这些检查确认客户端可以启动 stdio 进程，发现其工具，并传递环境变量。真实的求解请求还需要授权的目标参数和足够的账户余额。

步骤 5：按需启用基于浏览器的工具

基于浏览器的检测和页面交互需要可选的包附加组件以及 Playwright Chromium。

对于专用环境，运行：

python -m pip install "capsolver-mcp[browser]==0.1.3"
playwright install chromium

如果 MCP 客户端启动 uvx，请在包参数中包含浏览器附加组件：

{
  "mcpServers": {
    "capsolver-browser": {
      "command": "uvx",
      "args": ["--from", "capsolver-mcp[browser]==0.1.3", "capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_CAPSOLVER_API_KEY"
      }
    }
  }
}

Playwright 仍需要同一台机器上的兼容 Chromium 二进制文件。对于生产工作流，请固定版本，在预发布环境中测试升级，并将浏览器安装与应用密钥分开。

常见设置问题

大多数 CapSolver MCP 连接失败来自运行时路径、Python 版本、缺失凭据或可选浏览器依赖。

客户端报告 spawn uvx ENOENT

桌面应用程序无法在其进程 PATH 中看到 uvx。在 command 字段中使用绝对 uvx 路径，然后完全重启应用程序。

服务器启动但工具认证失败

CAPSOLVER_API_KEY 值缺失、格式错误或未传递到子进程。确认变量名称完全正确，替换占位符，并避免在 JSON 值中添加额外引号。

detect_captchas 或 solve_on_page 不可用

基础包未安装 Playwright。安装 capsolver-mcp[browser]，安装 Chromium，并重启客户端以启动更新环境。

注册表显示多个 CapSolver 结果

注册表搜索 API 可能返回同一服务器的多个已发布版本。选择 isLatest 为 true 的记录，或查询精确版本端点，而不是将结果数视为唯一性检查。

客户端连接但求解请求失败

区分连接问题和任务问题。首先验证工具发现和 get_balance；然后根据 CapSolver 文档 检查任务类型、网站 URL、站点密钥、可选字段和账户余额。

操作和负责任使用限制

CapSolver MCP 是本地工具接口，不是自动化目标的权限。仅在您拥有或被授权测试或自动化的网站和系统上使用。遵循适用的条款、隐私要求、速率限制和数据保留规则。

官方注册表确认了发布者控制的元数据和包位置；它不会取代您自己的安全审查。检查 CapSolver MCP 源代码仓库，在您的变更流程需要时固定版本，保护 API 密钥，并在广泛部署前测试更新。

对于超越单个客户端的架构决策，请参阅 企业 AI 代理团队如何构建授权挑战处理 并在设计服务边界时回顾 API 端点 的定义。

结论

官方 MCP 注册表现在为 CapSolver MCP 提供了规范的可搜索记录，而 PyPI 提供了可执行的 Python 包。可靠的设置遵循简短的序列：确认注册表身份，运行 CLI，将 CAPSOLVER_API_KEY 添加到客户端环境，重启客户端，并在尝试授权任务前验证工具发现。

使用 CapSolver 将文档化的 CAPTCHA 求解工具添加到支持的 AI 代理和浏览器自动化工作流中。

使用 CapSolver 构建可靠的自动化工作流

创建账户，安全存储 API 密钥，并在您被授权自动化的网站或系统上进行有限测试。CapSolver 常见问题解答 涵盖了在将集成移至生产环境之前常见的产品和账户问题。

常见问题

Q: CapSolver MCP 是否在官方 MCP 注册表中？

是的。注册表名称为 io.github.capsolver-ai/capsolver-mcp，版本 0.1.3 当前处于活动状态并标记为最新版本。

Q: 从注册表安装是否会创建托管的远程连接？

不。当前注册表条目描述的是通过 uvx 在 stdio 上本地启动的 PyPI 包；它不宣传 CapSolver 托管的远程 MCP 端点。

Q: 我需要全局安装 capsolver-mcp 吗？

不。uvx capsolver-mcp 在隔离环境中运行工具，而显式的 pip install 仍可用于管理自己虚拟环境的团队。

Q: 为什么我的客户端连接但不显示浏览器工具？

浏览器工具需要 capsolver-mcp[browser] 附加组件和 Playwright Chromium 安装。在安装这两个组件后重启客户端。

Q: CapSolver MCP 需要哪个环境变量？

CapSolver MCP 需要 CAPSOLVER_API_KEY。通过客户端环境传递它，并确保真实值不在源代码控制和支持截图中。

Q: 我可以在任何网站上使用 CapSolver MCP 吗？

不。仅在您拥有或被授权测试或自动化的网站和系统上使用 CapSolver MCP，并遵循适用的条款、隐私规则和法律要求。