Skip to content

本地运行 MCP 服务器

通过 npx 在本机以 stdio 方式运行 CaptchaSonic MCP 服务器——适用于只支持本地 MCP 服务器的客户端。

当您的客户端只支持本地（stdio）MCP 服务器时（例如 Claude Desktop 或部分智能体框架），请使用本地服务器。它与托管服务器 https://mcp.captchasonic.com 提供相同的工具并调用相同的 API。如果您的客户端支持远程服务器，使用托管服务器更简单。

需要 Node.js 20.3 或更高版本。

Claude Code

claude mcp add captchasonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server

JSON config

适用于 Claude Desktop、Cursor、Windsurf、Antigravity 以及任何使用 mcpServers 配置块的客户端：

{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}

Environment variables

变量说明默认值
SONIC_API_KEY您的 CaptchaSonic API 密钥。求解时必填
SONIC_BASE_URL求解 API 地址。https://api.captchasonic.com

Updating

npx 可能会复用缓存的副本。如需始终运行最新版本，请在命令中使用 @captchasonic/mcp-server@latest；如需固定版本，请使用 @captchasonic/[email protected]。

2.0.0 版本用 solve_token_captcha、solve_image_captcha、get_task_result、get_balance 和 list_captcha_types 取代了旧的 health_check 和 solve_captcha 工具。参见工具参考。