将 solvethree MCP 添加到 VS Code
将 solvethree 作为本地 stdio 服务器添加到 .vscode/mcp.json。VS Code 会启动可执行程序,并提供工作区 API 密钥和代理。服务器会创建求解任务并返回结果;它不会控制浏览器或填写表单。
本页内容
1. 添加本地服务器配置
使用以下配置创建或更新 .vscode/mcp.json。如果文件中已有其他服务器或输入项,请合并这些配置项,而不是替换它们。VS Code 必须能够在本地运行 npx。
{
"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.
- 2.
创建一个任务
让智能体使用
solvethree_create_recaptcha,将site设为主机名,提供所需的action,并为本次逻辑求解提供唯一的requestId。该工具还接受可选的recaptchaType和waitMs;类型默认为enterprise-v3。它从SOLVETHREE_PROXY读取其唯一使用的代理,因此不要在此工具调用中添加候选代理列表、type或url。 - 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 状态表示已生成解答,并不表示网站已接受应用程序的请求。如果目标拒绝请求,请先检查发出的请求,再付费进行另一次求解。
来源与 API 参考
运行您的第一个任务。
使用 $5 工作区额度开始体验。