capsolver-mcp

capsolver-mcp

面向 CapSolver 的 MCP 服务——通过 Model Context Protocol 向 AI Agent 提供验证码求解能力。

已发布到 PyPI，名称为 capsolver-mcp，并以 io.github.capsolver-ai/capsolver-mcp 列入官方 MCP Registry。

集成示例和完整文档请参阅 capsolver-ai-hub 仓库。

有关 MCP 客户端的详细设置说明（Claude Desktop、Claude Code、Cursor、Windsurf、Cline 等），请参阅 docs/mcp-integration.md。

安装

pip install capsolver-mcp
pip install capsolver-mcp[browser]   # with Playwright support (for detect/solve_on_page)

所有工具都从环境中读取 API 密钥：

# bash / zsh
export CAPSOLVER_API_KEY="your-capsolver-api-key"

# PowerShell
$env:CAPSOLVER_API_KEY = "your-capsolver-api-key"

# cmd
set CAPSOLVER_API_KEY=your-capsolver-api-key

使用方法

命令行

# stdio (default — for local MCP clients like Claude Desktop)
capsolver-mcp

# SSE (for remote / HTTP access)
capsolver-mcp --transport sse --host 0.0.0.0 --port 8000

# Streamable HTTP (MCP 2025-03-26 spec)
capsolver-mcp --transport streamable-http --host 0.0.0.0 --port 8000

命令行选项

capsolver-mcp [OPTIONS]

  --transport {stdio,sse,streamable-http}
                              Transport protocol (default: stdio)
  --host HOST                 Bind host for SSE/HTTP transports (default: 127.0.0.1)
  --port PORT                 Bind port for SSE/HTTP transports (default: 8000)
  --api-key KEY               API key (fallback: CAPSOLVER_API_KEY env)
  --name NAME                 Server name (default: capsolver)

编程方式

from capsolver_mcp.server import create_server

server = create_server(
    api_key="your-key",       # or set CAPSOLVER_API_KEY env var
    server_name="capsolver",  # name advertised to MCP clients
    host="127.0.0.1",         # bind host for SSE / HTTP transports
    port=8000,                # bind port for SSE / HTTP transports
)
server.run(transport="sse")   # or "stdio" or "streamable-http"

注意： host 和 port 是 create_server() 的构造函数参数 （会传递给 FastMCP），与 MCP Python SDK 1.x API 保持一致。

在 Claude Desktop 中配置

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "your-key"
      }
    }
  }
}

若要在不全局安装的情况下运行，请使用 "command": "uvx" 和 "args": ["capsolver-mcp"]——MCP 客户端会根据注册表条目生成此配置。请参阅 docs/mcp-integration.md， 了解各客户端的示例。

可用工具

工具	使用浏览器？	描述
solve_captcha	否	根据类型和站点参数求解验证码（令牌模式）
detect_captchas	是	扫描页面 URL 并列出页面上存在的验证码类型
solve_on_page	是	检测并求解页面上的所有验证码，然后自动填入
get_balance	否	查看账户余额和套餐
get_supported_captchas	否	列出所有支持的验证码类型和处理程序

基于浏览器的工具（detect_captchas、solve_on_page）需要安装 browser 附加组件：

pip install capsolver-mcp[browser]
playwright install chromium

开发

git clone https://github.com/capsolver-ai/capsolver-mcp.git
cd capsolver-mcp
uv sync --all-extras          # or: pip install -r requirements-dev.txt
uv run pytest                 # run tests
uv run ruff check src tests   # lint

许可证

MIT