Dịch vụ MCP

Cung cấp khả năng giải quyết của CapSolver cho các tác nhân AI thông qua Giao thức bối cảnh mô hình. Bất kỳ ứng dụng khách MCP nào sử dụng dịch vụ này đều nhận được năm công cụ giải quyết — không có mã keo.

1. Tổng quan

Giao thức bối cảnh mô hình (MCP) là một giao thức mở cho phép khách hàng AI khám phá và gọi các công cụ bên ngoài. Bạn đóng gói một khả năng dưới dạng dịch vụ MCP và mọi máy khách tương thích đều có thể sử dụng các công cụ của nó trực tiếp khi kết nối — mà không cần viết mã bộ điều hợp cho mỗi máy khách.

capsolver-mcp chính xác là một dịch vụ như vậy: nó bao gồm khả năng giải quyết của capsolver-core như các công cụ MCP tiêu chuẩn. Sau khi bắt đầu, các máy khách có khả năng MCP (Claude Desktop, Claude Code, Cursor, Cline và những người khác) sẽ tự động khám phá các công cụ và có thể gọi trực tiếp cho họ trong cuộc trò chuyện để phát hiện, giải quyết và điền lại — xóa CAPTCHA.

Lộ trình này phù hợp nhất với hai loại người: người dùng muốn giải quyết plug-and-play bên trong ứng dụng khách AI mà họ đã sử dụng mà không cần viết một dòng mã tích hợp; và các nhà phát triển muốn cung cấp khả năng giải quyết cho nhiều khách hàng của nhóm thông qua một giao thức thống nhất.

2. Cài đặt

capsolver-mcp được xây dựng dựa trên capsolver-core — lõi thực hiện việc giải quyết thực tế và mcp chỉ thể hiện khả năng của nó qua giao thức MCP — vì vậy, nó phụ thuộc vào capsolver-core khi chạy. Bạn không thể cài đặt mcp một mình: cài đặt lõi từ GitHub trước, sau đó là mcp:

# 1) Install the core engine first (mcp depends on it)
pip install git+https://github.com/capsolver-ai/capsolver-core.git
 
# 2) Then install mcp itself
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

Các công cụ trình duyệt ( detect / solve_on_page ) cũng cần Playwright - thay thế bước 2 bằng [browser] bổ sung và cài đặt Chrome:

pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

3. Công cụ

Sau khi bắt đầu, dịch vụ sẽ quảng cáo năm công cụ sau cho khách hàng:

Công cụ	Trình duyệt?	Mô tả
`solve_captcha`	Không	Giải quyết theo loại + thông số trang web (Chế độ mã thông báo)
`detect_captchas`	Có	Quét URL trang và liệt kê các loại CAPTCHA hiện có
`solve_on_page`	Có	Phát hiện + giải quyết + điền lại mọi CAPTCHA trên trang
`get_balance`	Không	Truy vấn số dư tài khoản và các gói
`get_supported_captchas`	Không	Liệt kê tất cả các loại và trình xử lý CAPTCHA được hỗ trợ

Các công cụ trình duyệt ( detect_captchas , solve_on_page ) yêu cầu bổ sung [browser] và Chrome — chỉ cần cài đặt theo hướng dẫn trình duyệt ở trên.

4. Khởi động dịch vụ

4.1 Dòng lệnh

# stdio (default — for local MCP clients such as 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

Tùy chọn dòng lệnh:

capsolver-mcp [OPTIONS]
  --transport {stdio,sse,streamable-http}   Transport protocol (default: stdio)
  --host HOST                 Bind host for SSE/HTTP transport (default: 127.0.0.1)
  --port PORT                 Bind port for SSE/HTTP transport (default: 8000)
  --api-key KEY               API key (falls back to the CAPSOLVER_API_KEY env var)
  --name NAME                 Service name (default: capsolver)

Cấu hình 4.2 MCP

Máy khách MCP tải dịch vụ này thông qua một khối cấu hình JSON. Phổ biến nhất là cách tiếp cận stdio: máy khách khởi chạy dịch vụ dưới dạng một tiến trình con bằng cách sử dụng lệnh bạn cung cấp. Đặt trực tiếp command thành gói capsolver-mcp:

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

Nếu máy khách báo cáo rằng nó không thể tìm thấy capsolver-mcp (phổ biến khi nó được cài đặt trong môi trường conda / venv không có trên PATH của máy khách), hãy trỏ command vào Python của môi trường đó và khởi chạy thông qua mô-đun:

{
  "mcpServers": {
    "capsolver": {
      "command": "/abs/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

5. Trình diễn công cụ & thiết lập ứng dụng khách

Hầu hết các máy khách MCP đều kết nối với khối cấu hình từ §4.2. Dưới đây là các bước cụ thể cho VS Code, một số bản demo công cụ và sự khác biệt đối với các ứng dụng khách khác.

5.1 Mã VS (plugin Claude)

Tạo một mcp.json mới.
Thêm cấu hình tương ứng trong mcpServers .
Tải lại mã VS. Sau khi tải lại, năm công cụ của CapSolver xuất hiện trong danh sách công cụ.

5.2 Trình diễn công cụ

Chỉ cần sử dụng ngôn ngữ tự nhiên để khách hàng gọi một công cụ. Dưới đây là ba cách sử dụng điển hình và kết quả mong đợi của chúng:

Kiểm tra số dư — “Sử dụng capsolver để kiểm tra số dư tài khoản của tôi.” Khách hàng gọi get_balance và trả lại số dư và gói hàng.

Giải quyết chế độ mã thông báo — cung cấp loại, URL và khóa trang web: “Giải reCAPTCHA v2 này cho tôi.” Máy khách gọi solve_captcha và trả về mã thông báo.

Toàn bộ trang, một lần — “Phát hiện và giải mọi CAPTCHA trên trang này: <URL> .” Client gọi solve_on_page để phát hiện + giải quyết + điền lại.

5.3 Các client khác

Cấu hình command + env tương tự áp dụng cho các máy khách MCP stdio khác. Đây là con trỏ làm ví dụ:

Lưu ý: điều kiện tiên quyết để Con trỏ kết nối với capsolver-mcp là cả hai gói đều được cài đặt:
#1) Cài core engine trước (mcp tùy vào nó)
cài đặt pip git+ https://github.com/capsolver-ai/capsolver-core.git
#2) Sau đó tự cài mcp
cài đặt pip git+ https://github.com/capsolver-ai/capsolver-mcp.git

Công cụ Agent Tại sao chọn CapSolver?