English Français العربية

io.github.capsolver-ai/capsolver-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP Server for CapSolver - captcha-solving capabilities for AI agents

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package capsolver-mcp
Claude Code 
claude mcp add capsolver-mcp -e 'CAPSOLVER_API_KEY=<your capsolver_api_key>' -- uvx capsolver-mcp==0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "capsolver-mcp": {
            "command": "uvx",
            "args": [
                "capsolver-mcp==0.1.3"
            ],
            "env": {
                "CAPSOLVER_API_KEY": "<your capsolver_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • CAPSOLVER_API_KEY إلزامي سري Your CapSolver API key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. capsolver-mcp
  2. Install
  3. Usage
  4. Configure in Claude Desktop
  5. Available tools
  6. Development
  7. License

capsolver-mcp

MCP Server for CapSolver — expose captcha-solving capabilities to AI agents via the Model Context Protocol.

Published on PyPI as capsolver-mcp and listed in the official MCP Registry as io.github.capsolver-ai/capsolver-mcp.

See the capsolver-ai-hub repo for integration examples and the full documentation.

For detailed MCP client setup (Claude Desktop, Claude Code, Cursor, Windsurf, Cline, and more), see docs/mcp-integration.md.

Install

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

All tools read the API key from the environment:

# 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

Usage

CLI
# 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
CLI options
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)
Programmatic
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"

Note: host and port are constructor parameters on create_server() (forwarded to FastMCP), matching the MCP Python SDK 1.x API.

Configure in Claude Desktop

Add to your claude_desktop_config.json:

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

To run without installing it globally, use "command": "uvx" with "args": ["capsolver-mcp"] — this is what MCP clients generate from the registry entry. See docs/mcp-integration.md for per-client examples.

Available tools

ToolBrowser?Description
solve_captchaNoSolve a captcha by type + site params (token mode)
detect_captchasYesScan a page URL and list present captcha types
solve_on_pageYesDetect + solve + autofill all captchas on a page
get_balanceNoCheck account balance and packages
get_supported_captchasNoList all supported captcha types and handlers

Browser-based tools (detect_captchas, solve_on_page) require the browser extra:

pip install capsolver-mcp[browser]
playwright install chromium

Development

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

License

MIT

الأسئلة الشائعة

ما هو io.github.capsolver-ai/capsolver-mcp؟

MCP Server for CapSolver - captcha-solving capabilities for AI agents

كيف أثبّت io.github.capsolver-ai/capsolver-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add capsolver-mcp -e 'CAPSOLVER_API_KEY=<your capsolver_api_key>' -- uvx capsolver-mcp==0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.capsolver-ai/capsolver-mcp إلى مفتاح API؟

نعم. يتطلب CAPSOLVER_API_KEY، وتضبطها في إعداداته.

هل io.github.capsolver-ai/capsolver-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.capsolver-ai/capsolver-mcp؟

ينشره capsolver-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.