Máy chủ MCP của CapSolver đã có sẵn cho các tác nhân AI

TL;DR

• CapSolver MCP Server hiện đã có trên PyPI dưới dạng capsolver-mcp. Phiên bản 0.1.1 cài đặt trên Python 3.10 hoặc cao hơn và tự động cài đặt capsolver-core như một phụ thuộc chạy thời gian.
• Server cung cấp năm công cụ của CapSolver cho các khách hàng AI tương thích MCP. Chúng bao gồm giải CAPTCHA theo chế độ token, phát hiện CAPTCHA, giải CAPTCHA và điền kết quả trong trình duyệt, kiểm tra số dư tài khoản, và phát hiện loại được hỗ trợ.
• Giao thức stdio mặc định được thiết kế cho các khách hàng MCP cục bộ. Giao thức SSE và Streamable HTTP cũng có sẵn cho các triển khai cần endpoint mạng.
• Công cụ trình duyệt là tùy chọn. Cài đặt phần mở rộng browser và Chromium chỉ khi quy trình cần phát hiện trang hoặc điền kết quả trong trình duyệt.
• CapSolver MCP Server dành cho tự động hóa được ủy quyền. Truy cập kỹ thuật không cấp phép tự động hóa hệ thống riêng tư, bị hạn chế hoặc không được ủy quyền.

CapSolver MCP Server mang khả năng xử lý CAPTCHA đến các trợ lý AI

Các trợ lý AI có thể lập kế hoạch nhiệm vụ, điều khiển trình duyệt và gọi công cụ bên ngoài, nhưng một bước kiểm tra xác minh có thể làm gián đoạn một chuỗi tự động hóa hợp lệ. CapSolver MCP Server cung cấp giao diện công cụ tiêu chuẩn cho các khách hàng AI tương thích để xử lý các thách thức CAPTCHA được hỗ trợ trong các quy trình được ủy quyền. Nền tảng CapSolver Agent Automation rộng hơn kết nối cùng cơ sở hạ tầng này với các khung framework trợ lý, công cụ trình duyệt và tích hợp SDK trực tiếp.

Gói này kết nối CapSolver với Model Context Protocol, một giao thức mở mà các ứng dụng AI sử dụng để phát hiện và gọi các khả năng bên ngoài. Thay vì triển khai mã nối riêng cho mỗi khách hàng tương thích, các nhóm có thể cấu hình một máy chủ MCP và tiết lộ cùng bộ công cụ CapSolver qua giao thức.

Phiên bản phát hành công khai đầu tiên là 0.1.0. Phiên bản 0.1.1 hiện đã có với tài liệu cập nhật và cài đặt sạch. Gói hỗ trợ Python 3.10 đến 3.13 và được công bố dưới giấy phép MIT.

Những thay đổi nào trong bản phát hành MCP

Bản phát hành MCP biến chức năng CapSolver thành năm công cụ có tên mà một khách hàng AI có thể phát hiện sau khi kết nối với máy chủ. Mô hình có thể chọn công cụ dựa trên nhiệm vụ, trong khi CapSolver MCP Server xử lý thao tác SDK tương ứng.

CapSolver MCP Server sử dụng capsolver-core ở lớp công cụ này. Lệnh pip install capsolver-mcp thông thường tự động cài đặt gói Core yêu cầu, vì vậy người dùng không cần cài đặt phụ thuộc riêng. Phần mở rộng trình duyệt tùy chọn thêm hỗ trợ Playwright cho detect_captchas và solve_on_page.

Máy chủ cũng cung cấp ba lựa chọn giao thức. Stdio là mặc định cho khách hàng cục bộ khởi động máy chủ như quy trình con. SSE và Streamable HTTP có thể liên kết với host và cổng được cấu hình cho các triển khai trong đó khách hàng MCP kết nối qua ranh giới mạng.

Ai nên sử dụng CapSolver MCP Server

CapSolver MCP Server phù hợp nhất với các nhóm đã sử dụng ứng dụng AI tương thích MCP và muốn tích hợp theo cấu hình đầu tiên. Đường đi MCP tránh việc viết lớp bao quanh đặc trưng khung trước khi trợ lý có thể phát hiện công cụ CapSolver.

Những trường hợp phù hợp bao gồm các luồng QA được ủy quyền, RPA được phép, giám sát nội bộ và các luồng dữ liệu công khai được phê duyệt trong đó trợ lý có thể gặp bước xác minh được hỗ trợ. Một nhóm cũng có thể tiết lộ dịch vụ mạng chung cho nhiều khách hàng tương thích, tuân theo yêu cầu xác thực, mạng và kiểm soát truy cập của riêng họ.

CapSolver cung cấp hai lớp tích hợp khác cho các nhà phát triển cần nhiều kiểm soát hơn. capsolver-agent cung cấp các lược đồ công cụ khung không đặc trưng và trình thực thi cho các vòng lặp trợ lý tùy chỉnh và tích hợp khung được hỗ trợ. capsolver-core cung cấp SDK Python nền tảng để truy cập API trực tiếp và tự động hóa trình duyệt mà không cần LLM. Tổng quan tích hợp CapSolver AI giải thích khi nào nên chọn MCP, Công cụ Agent hoặc SDK Core, trong khi tổ chức GitHub CapSolver AI chứa các gói công khai và ví dụ tích hợp.

Nhận mã thưởng CapSolver của bạn

Tăng ngân sách tự động hóa của bạn ngay lập tức!
Sử dụng mã thưởng CAP26 khi nạp tiền tài khoản CapSolver để nhận thêm 5% thưởng trên mỗi lần nạp — không giới hạn.
Nhận mã ngay bây giờ trong Bảng điều khiển CapSolver

Đường đi cài đặt đã được xác minh

Đường đi cài đặt ngắn nhất sử dụng Python 3.10 hoặc cao hơn và gói được công bố trên PyPI. Lệnh sau đã được kiểm tra trong môi trường Python 3.12 sạch với phiên bản 0.1.1:

python -m pip install capsolver-mcp==0.1.1

Cài đặt sạch tự động kéo capsolver-core và cài đặt lệnh capsolver-mcp. Chạy lệnh giúp xác nhận các tùy chọn giao thức stdio, SSE và Streamable HTTP được tài liệu hóa:

capsolver-mcp --help

Đối với phát hiện và điền kết quả dựa trên trình duyệt, cài đặt phần mở rộng tùy chọn và môi trường Chromium:

python -m pip install "capsolver-mcp[browser]==0.1.1"
playwright install chromium

Phần mở rộng trình duyệt không cần thiết cho solve_captcha, get_balance hoặc get_supported_captchas. Giữ phụ thuộc trình duyệt là tùy chọn giúp cài đặt cơ bản nhỏ hơn cho các quy trình chỉ sử dụng token.

Trước khi khởi động máy chủ, tạo tài khoản CapSolver và lưu thông tin xác thực trong biến môi trường CAPSOLVER_API_KEY. Một khóa API là thông tin xác thực và nên ở ngoài mã nguồn, hình chụp màn hình, báo cáo vấn đề và tệp cấu hình công khai.

export CAPSOLVER_API_KEY="your-capsolver-api-key"
capsolver-mcp

Máy chủ khởi động ở chế độ stdio mặc định. Màn hình có thể dường như bị chiếm giữ vì quy trình đang chờ trao đổi tin nhắn giao thức qua đầu vào và đầu ra chuẩn.

Cấu hình khách hàng MCP

Một khách hàng MCP cần lệnh máy chủ và biến môi trường khóa API. Cấu hình sau tuân theo cấu trúc được tài liệu hóa bởi CapSolver cho khách hàng stdio cục bộ:

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

Lưu khối này tại vị trí yêu cầu bởi khách hàng được chọn, khởi động lại khách hàng và kiểm tra các công cụ có sẵn. Năm công cụ CapSolver nên xuất hiện sau khi kết nối thành công. Bạn có thể sau đó yêu cầu khách hàng sử dụng get_supported_captchas hoặc get_balance như kiểm tra cấu hình tác động thấp trước khi kiểm tra quy trình giải CAPTCHA.

Nếu khách hàng không thể tìm thấy capsolver-mcp, quy trình có thể không kế thừa môi trường shell nơi gói được cài đặt. Một tùy chọn là sử dụng uvx, mà hướng dẫn khách hàng chi tiết của dự án hỗ trợ:

{
  "mcpServers": {
    "capsolver": {
      "command": "uvx",
      "args": ["capsolver-mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Một tùy chọn khác là chỉ định command đến đường dẫn Python tuyệt đối bên trong môi trường và sử dụng "args": ["-m", "capsolver_mcp"]. Hướng dẫn cấu hình khách hàng MCP CapSolver chứa các đường dẫn và ví dụ cụ thể cho Claude Desktop, Claude Code, Cursor, Windsurf, Cline và thiết lập HTTP từ xa.

Chọn giao thức phù hợp

Giao thức nên phù hợp với nơi máy chủ và khách hàng MCP chạy. Các công cụ máy tính để bàn cục bộ nên bắt đầu với stdio vì khách hàng sở hữu quy trình máy chủ và không cần cổng mạng lắng nghe.

Streamable HTTP phù hợp khi máy chủ chạy như dịch vụ được quản lý riêng và khách hàng hỗ trợ điểm cuối MCP HTTP. SSE vẫn có sẵn cho khách hàng hoặc triển khai hiện có cần nó. Máy chủ hiển thị các cờ host và cổng cho cả hai chế độ mạng:

capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000

Gắn với 127.0.0.1 giữ endpoint cục bộ. Gắn với 0.0.0.0 khiến nó có thể truy cập qua các giao diện mạng hiện có và do đó yêu cầu kiểm soát xác thực, tường lửa, proxy, TLS, quản lý bí mật và ghi nhật ký có chủ đích. Không nên công khai máy chủ chứa khóa API trực tiếp lên internet công cộng.

Những gì cần kiểm tra sau khi cài đặt

Một cài đặt thành công không tự động xác nhận rằng khách hàng, môi trường, tài khoản và runtime trình duyệt tùy chọn đều được kết nối chính xác. Kiểm tra tích hợp theo từng giai đoạn:

1. Xác nhận rằng khách hàng báo cáo máy chủ MCP CapSolver là đã kết nối.
2. Xác nhận rằng tất cả năm tên công cụ mong đợi đều hiển thị.
3. Gọi get_supported_captchas để kiểm tra thực thi công cụ mà không cần mở trình duyệt.
4. Gọi get_balance để xác nhận khóa API có sẵn cho máy chủ.
5. Thử giải CAPTCHA chỉ trên trang hoặc hệ thống bạn sở hữu hoặc có quyền tự động hóa rõ ràng.
6. Cài đặt phần mở rộng trình duyệt riêng trước khi kiểm tra detect_captchas hoặc solve_on_page.

Thông tin tài liệu dịch vụ MCP chính thức chứa mô tả công cụ hiện tại, cờ dòng lệnh, định dạng cấu hình và yêu cầu trình duyệt. Kho lưu trữ MCP CapSolver công khai chứa mã nguồn, lịch sử thay đổi, lệnh phát triển, bộ theo dõi vấn đề và giấy phép MIT. Trang gói PyPI là nguồn cung cấp tệp gói đã công bố và khả năng phiên bản.

Khám phá tích hợp tự động hóa trợ lý CapSolver

CapSolver MCP Server là một điểm vào vào hệ sinh thái tự động hóa trợ lý rộng lớn. Chọn trang tích hợp phù hợp với khung hoặc runtime trình duyệt đã sử dụng bởi quy trình:

Các trang tích hợp cung cấp hướng dẫn cấp sản phẩm, trong khi các kho capsolver-mcp, capsolver-agent và capsolver-core cung cấp các gói cài đặt, mã nguồn, ví dụ và theo dõi vấn đề.

Giới hạn và sử dụng có trách nhiệm

CapSolver MCP Server cung cấp công cụ; nó không xác định xem một nhiệm vụ tự động hóa có được ủy quyền hay không. Người dùng vẫn chịu trách nhiệm về luật pháp áp dụng, điều khoản trang, quyền tài khoản, yêu cầu xử lý dữ liệu và chính sách tổ chức.

Các thao tác dựa trên trình duyệt yêu cầu Playwright và cài đặt Chromium, trong khi công cụ chế độ token không điều khiển trình duyệt. Một khách hàng MCP tương thích cũng cần thiết: việc cài đặt gói không thêm hỗ trợ MCP vào ứng dụng thiếu giao thức.

Gói hiện được đánh dấu là Alpha trong dữ liệu dự án Python của nó. Gắn phiên bản đã kiểm tra là phù hợp cho môi trường kiểm soát, và các nhóm nên xem nhật ký thay đổi trước khi nâng cấp. Các giao thức mạng yêu cầu các biện pháp an toàn vận hành bổ sung vì chúng thay đổi ranh giới tin cậy từ quy trình con cục bộ thành dịch vụ có thể truy cập.

CapSolver MCP Server sẵn sàng cho việc áp dụng có kiểm soát

CapSolver MCP Server cung cấp cách tiêu chuẩn để đưa năm khả năng CapSolver đến các khách hàng AI tương thích MCP. Gói cài đặt thông qua PyPI, hỗ trợ giao thức cục bộ và mạng, giữ phụ thuộc trình duyệt là tùy chọn và tiết lộ đường đi cấu hình được tài liệu hóa cho các công cụ phát triển MCP chính.

Bắt đầu với cấu hình stdio cục bộ, xác nhận phát hiện công cụ và truy cập tài khoản, sau đó kiểm tra quy trình giới hạn trong môi trường được ủy quyền. Xem xét mã nguồn gói và báo cáo các vấn đề kỹ thuật thông qua bộ theo dõi vấn đề GitHub của dự án.

Xây dựng các quy trình tự động hóa đáng tin cậy với CapSolver

Bắt đầu với trang tích hợp MCP CapSolver, theo hướng dẫn Dịch vụ MCP và xem triển khai trong kho GitHub capsolver-mcp. Sử dụng CapSolver chỉ cho tự động hóa hợp pháp, được ủy quyền và các quy trình dữ liệu công khai được phê duyệt.

FAQ

Câu hỏi: CapSolver MCP Server là gì?

CapSolver MCP Server là một gói Python hiển thị năm khả năng CapSolver dưới dạng công cụ qua Giao thức Bối cảnh Mô hình. Các khách hàng AI tương thích có thể phát hiện và gọi các công cụ đó sau khi máy chủ được cấu hình.

Câu hỏi: Tôi có cần cài đặt capsolver-core riêng biệt không?
Không. Gói capsolver-mcp được phát hành khai báo capsolver-core là dependency thời gian chạy, do đó cài đặt pip thông thường sẽ cài đặt nó tự động. Các công cụ trình duyệt vẫn cần browser (tùy chọn) và Chromium.

Câu hỏi: Phiên bản Python nào được hỗ trợ?

MCP Server của CapSolver hiện tại yêu cầu Python 3.10 hoặc mới hơn, và thông tin dự án liệt kê Python 3.10, 3.11, 3.12 và 3.13.

Câu hỏi: Mọi công cụ đều yêu cầu Playwright không?

Không. Chỉ detect_captchas và solve_on_page yêu cầu hỗ trợ trình duyệt. Giải mã token, kiểm tra số dư và phát hiện loại được hỗ trợ hoạt động với gói cơ bản.

Câu hỏi: MCP Server của CapSolver có thể được mở rộng thành dịch vụ từ xa không?

Có. Máy chủ hỗ trợ SSE và HTTP có thể stream ngoài việc sử dụng stdio địa phương, nhưng việc mở rộng từ xa yêu cầu xác thực phù hợp, TLS, quy tắc tường lửa, quản lý bí mật và ghi nhật ký truy cập.