将 solvethree MCP 添加到 VS Code

作者:solvethree阅读需 1 分钟

将 solvethree 作为本地 stdio 服务器添加到 .vscode/mcp.json。VS Code 会启动可执行程序,并提供工作区 API 密钥和代理。服务器会创建求解任务并返回结果;它不会控制浏览器或填写表单。

本页内容

1. 添加本地服务器配置

使用以下配置创建或更新 .vscode/mcp.json。如果文件中已有其他服务器或输入项,请合并这些配置项,而不是替换它们。VS Code 必须能够在本地运行 npx。

VS Code · 本地测试框架 stdio 服务器
{
  "inputs": [
    {
      "type": "promptString",
      "id": "solvethree-key",
      "description": "solvethree workspace API key",
      "password": true
    },
    {
      "type": "promptString",
      "id": "solvethree-proxy",
      "description": "HTTP(S) target proxy URL",
      "password": true
    }
  ],
  "servers": {
    "solvethree": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "--package=https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz",
        "solvethree-mcp"
      ],
      "env": {
        "SOLVETHREE_API_KEY": "${input:solvethree-key}",
        "SOLVETHREE_PROXY": "${input:solvethree-proxy}"
      }
    }
  }
}

该命令会运行官方 SDK 下载内容中的 solvethree-mcp。两个密码输入提示会向该进程提供 SOLVETHREE_API_KEY 和 SOLVETHREE_PROXY。请在这些提示中输入工作区 API 密钥和 HTTP(S) 代理 URL,不要在聊天中或提交到版本控制的配置文件中输入。代理 URL 不得包含路径、查询参数或片段。

配置结构详见 VS Code MCP 配置参考。这是本地进程,而非托管的 MCP 端点。

2. 检查可用工具

VS Code 启动服务器后,请让智能体先调用 solvethree_capabilities,然后再请求求解。服务器提供以下工具:

  • solvethree_capabilities — 查看服务能力。
  • solvethree_create_recaptcha — 创建 reCAPTCHA 任务。
  • solvethree_create_kasada — 创建独立的 Kasada 任务;目前仅支持 www.ticketmaster.com 上的 HTTPS 目标。
  • solvethree_create_tmpt — 为 Event 或 Login 创建 Ticketmaster TMPT 任务。
  • solvethree_get_task — 获取任务状态和结果。

如果这些工具不可用,请先检查本地进程是否启动并接收到两个环境变量。更改目标站点或创建另一个任务无法解决服务器启动问题。

3. 请求 reCAPTCHA 解答

  1. 1.

    激活站点配置

    在站点配置中使用正确的主机名、采集操作和 reCAPTCHA 类型设置目标。求解前,工作区必须有可用且已激活的配置。向工具提供主机名和操作不会创建配置。如果这是新目标,请参阅站点配置设置。

  2. 2.

    创建一个任务

    让智能体使用 solvethree_create_recaptcha,将 site 设为主机名,提供所需的 action,并为本次逻辑求解提供唯一的 requestId。该工具还接受可选的 recaptchaType 和 waitMs;类型默认为 enterprise-v3。它从 SOLVETHREE_PROXY 读取其唯一使用的代理,因此不要在此工具调用中添加候选代理列表、type 或 url。

  3. 3.

    跟踪任务直至终态

    每次创建调用最多生成一个任务。如果其状态为 pending 或 solving,请使用 solvethree_get_task 再次获取。只有 ready 状态才包含可用的解答。遇到 failed 时,停止轮询并检查 errorCode 和 error;解答失败会退款。不要使用未更改的无效输入重试。

如果创建超时,请保留 requestId。它必须包含 1–64 个 ASCII 字母、数字、下划线或连字符。使用相同 ID 重复相同的任务请求会返回现有任务;复用该 ID 时更改输入会产生冲突。请先找回现有任务,再请求新的逻辑求解。

4. 从应用程序提交解答

对于 reCAPTCHA,请将 solution.token 提交给预期目标,而不是提交任务 ID。使用返回的 userAgent 和 secChUa,并使用求解时的同一代理。切换 IP 或混用不相关的浏览器请求头可能导致提交失败。

其他工具返回的内容不同:Kasada 返回需一同应用的请求头对象,而 TMPT 返回原始 tmpt Cookie 值。请将每个结果与其关联的浏览器身份、代理和目标配套使用。

MCP 宿主会接收私密解答数据,但不会替你提交。任务处于 ready 状态表示已生成解答,并不表示网站已接受应用程序的请求。如果目标拒绝请求,请先检查发出的请求,再付费进行另一次求解。

运行您的第一个任务。

使用 $5 工作区额度开始体验。

创建工作区
将 solvethree MCP 添加到 VS Code · solvethree