capsolver-mcp

capsolver-mcp

CapSolver の MCP サーバーです。Model Context Protocol を介して、AI エージェントから CAPTCHA 解決機能を利用できるようにします。

PyPI では capsolver-mcp として公開されており、公式の MCP Registry には io.github.capsolver-ai/capsolver-mcp として登録されています。

統合例とドキュメント全文については、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	いいえ	種類とサイトのパラメーターを指定して CAPTCHA を解決します（トークンモード）
detect_captchas	はい	ページ URL をスキャンして、存在する CAPTCHA の種類を一覧表示します
solve_on_page	はい	ページ上のすべての CAPTCHA を検出、解決し、自動入力します
get_balance	いいえ	アカウント残高とパッケージを確認します
get_supported_captchas	いいえ	サポートされている CAPTCHA の種類とハンドラーをすべて一覧表示します

ブラウザーベースのツール（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