
Emma Foster
Machine Learning Engineer

capsolver-mcp. Versi 0.1.1 dapat diinstal pada Python 3.10 atau lebih baru dan secara otomatis menginstal capsolver-core sebagai dependensi runtime.extra browser dan Chromium hanya saat alur kerja membutuhkan deteksi halaman atau pengisian hasil kembali di browser.Agen AI dapat merencanakan tugas, mengoperasikan browser, dan memanggil alat eksternal, tetapi checkpoint verifikasi dapat mengganggu jalur otomasi yang valid. CapSolver MCP Server memberikan antarmuka alat standar kepada klien AI yang kompatibel untuk menangani tantangan CAPTCHA yang didukung dalam alur kerja yang diizinkan. Platform CapSolver Agent Automation yang lebih luas menghubungkan infrastruktur yang sama ke kerangka agen, alat browser, dan integrasi SDK langsung.
Paket ini menghubungkan CapSolver ke Model Context Protocol, protokol terbuka melalui mana aplikasi AI menemukan dan memanggil kemampuan eksternal. Alih-alih mengimplementasikan kode glue terpisah untuk setiap klien yang kompatibel, tim dapat mengonfigurasi satu server MCP dan mengekspos set alat CapSolver yang sama melalui protokol tersebut.
Rilis publik pertama dirilis sebagai versi 0.1.0. Versi 0.1.1 sekarang tersedia dengan dokumentasi penerbitan dan pemasangan yang diperbarui. Paket ini mendukung Python 3.10 hingga 3.13 dan diterbitkan di bawah lisensi MIT.
Rilis MCP mengubah fungsionalitas CapSolver menjadi lima alat bernama yang dapat ditemukan oleh klien AI setelah terhubung ke server. Model dapat memilih alat berdasarkan tugas, sementara CapSolver MCP Server menangani operasi SDK yang sesuai.
| Alat | Membutuhkan browser? | Tujuan |
|---|---|---|
solve_captcha |
Tidak | Menyelesaikan CAPTCHA yang didukung menggunakan tipe tugas dan parameter situs dalam mode token |
detect_captchas |
Ya | Memeriksa halaman dan melaporkan jenis CAPTCHA yang didukung yang ada |
solve_on_page |
Ya | Mendeteksi tantangan yang didukung, meminta solusi, dan mengisi hasil kembali ke halaman |
get_balance |
Tidak | Memeriksa saldo akun dan paket CapSolver |
get_supported_captchas |
Tidak | Mengembalikan jenis CAPTCHA dan handler yang tersedia untuk paket yang terinstal |
CapSolver MCP Server menggunakan capsolver-core di bawah lapisan alat ini. Perintah pip install capsolver-mcp biasa secara otomatis menginstal paket Core yang diperlukan, sehingga pengguna tidak perlu menginstal dependensi secara terpisah. Ekstra browser opsional menambahkan dukungan Playwright untuk detect_captchas dan solve_on_page.
Server juga menawarkan tiga pilihan transport. Stdio adalah default untuk klien lokal yang menjalankan server sebagai proses anak. SSE dan Streamable HTTP dapat terikat ke host dan port yang dikonfigurasi untuk deployment di mana klien MCP terhubung melalui batas jaringan.
CapSolver MCP Server cocok untuk tim yang sudah menggunakan aplikasi AI yang kompatibel dengan MCP dan ingin integrasi berbasis konfigurasi. Jalur MCP menghindari penulisan wrapper khusus kerangka sebelum agen dapat menemukan alat CapSolver.
Kasus umum termasuk alur QA yang diizinkan, RPA yang diizinkan, pemantauan internal, dan alur kerja data publik yang disetujui di mana agen mungkin menghadapi langkah verifikasi yang didukung. Tim juga dapat mengekspos layanan jaringan bersama ke beberapa klien yang kompatibel, sesuai dengan persyaratan otentikasi, jaringan, dan kontrol akses mereka sendiri.
CapSolver menyediakan dua lapisan integrasi lain untuk pengembang yang membutuhkan kontrol lebih banyak. capsolver-agent menyediakan skema alat agen yang tidak bergantung pada kerangka dan executor untuk loop agen kustom dan integrasi kerangka yang didukung. capsolver-core menyediakan SDK Python dasar untuk API langsung dan otomasi browser tanpa memerlukan LLM. Panduan integrasi CapSolver untuk agen AI menjelaskan kapan memilih MCP, Alat Agent, atau SDK Core, sementara organisasi GitHub CapSolver AI berisi paket publik dan contoh integrasi.
Klaim Kode Bonus CapSolver Anda
Tingkatkan anggaran otomasi Anda secara instan!
Gunakan kode bonus CAP26 saat menambahkan akun CapSolver Anda untuk mendapatkan tambahan 5% bonus pada setiap penyetoran — tanpa batas.
Klaim sekarang di Dasbor CapSolver Anda
Jalur instalasi terpendek menggunakan Python 3.10 atau lebih baru dan paket yang diterbitkan di PyPI. Perintah berikut telah diverifikasi dalam lingkungan Python 3.12 bersih dengan versi 0.1.1:
python -m pip install capsolver-mcp==0.1.1
Instalasi bersih secara otomatis menarik capsolver-core dan menginstal perintah capsolver-mcp. Menjalankan perintah bantuan memastikan opsi transport stdio, SSE, dan Streamable HTTP yang didokumentasikan:
capsolver-mcp --help
Untuk deteksi dan pengisian hasil kembali berbasis browser, instal ekstra opsional dan runtime Chromium:
python -m pip install "capsolver-mcp[browser]==0.1.1"
playwright install chromium
Ekstra browser tidak diperlukan untuk solve_captcha, get_balance, atau get_supported_captchas. Mempertahankan dependensi browser opsional membuat instalasi dasar lebih kecil untuk alur kerja hanya token.
Sebelum memulai server, buat akun CapSolver dan simpan kredensial di variabel lingkungan CAPSOLVER_API_KEY. Kunci API adalah kredensial dan harus tetap di luar kode sumber, tangkapan layar, laporan masalah, dan file konfigurasi publik.
export CAPSOLVER_API_KEY="your-capsolver-api-key"
capsolver-mcp
Server dimulai dalam mode stdio secara default. Terminal mungkin tampak terjebak karena proses menunggu klien MCP untuk bertukar pesan protokol melalui input dan output standar.
Klien MCP membutuhkan perintah server dan variabel lingkungan kunci API. Konfigurasi berikut mengikuti struktur yang didokumentasikan oleh CapSolver untuk klien stdio lokal:
{
"mcpServers": {
"capsolver": {
"command": "capsolver-mcp",
"env": {
"CAPSOLVER_API_KEY": "YOUR_API_KEY"
}
}
}
}
Simpan blok tersebut di lokasi yang dibutuhkan oleh klien yang dipilih, restart klien, dan periksa alat yang tersedia. Lima alat CapSolver seharusnya muncul setelah koneksi yang berhasil. Anda kemudian dapat meminta klien untuk menggunakan get_supported_captchas atau get_balance sebagai pemeriksaan konfigurasi yang rendah dampaknya sebelum menguji alur kerja penyelesaian.
Jika klien tidak dapat menemukan capsolver-mcp, prosesnya mungkin tidak mewarisi lingkungan shell di mana paket diinstal. Salah satu opsi adalah menggunakan uvx, yang didukung oleh panduan klien proyek yang rinci:
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": ["capsolver-mcp"],
"env": {
"CAPSOLVER_API_KEY": "YOUR_API_KEY"
}
}
}
}
Opsi lain adalah menunjuk command ke jalur Python absolut di dalam lingkungan dan menggunakan "args": ["-m", "capsolver_mcp"]. Panduan konfigurasi klien MCP CapSolver berisi jalur dan contoh khusus klien untuk Claude Desktop, Claude Code, Cursor, Windsurf, Cline, dan setup HTTP jarak jauh.
Transport harus sesuai dengan lokasi klien dan server MCP berjalan. Alat desktop lokal biasanya dimulai dengan stdio karena klien mengelola proses server dan tidak memerlukan port jaringan yang didengarkan.
Streamable HTTP cocok ketika server berjalan sebagai layanan yang dikelola terpisah dan klien mendukung titik akhir MCP HTTP. SSE tetap tersedia untuk klien atau deployment yang membutuhkannya. Server mengekspos bendera host dan port untuk kedua mode jaringan:
capsolver-mcp --transport streamable-http --host 127.0.0.1 --port 8000
Mengikat ke 127.0.0.1 menjaga endpoint lokal pada mesin. Mengikat ke 0.0.0.0 membuatnya dapat diakses melalui antarmuka jaringan yang tersedia dan oleh karena itu memerlukan otentikasi, firewall, proxy, manajemen rahasia, dan kontrol pencatatan yang sengaja diterapkan. Jangan mengekspos server yang mengandung kunci API langsung ke internet publik.
Instalasi yang berhasil tidak secara otomatis memastikan bahwa klien, lingkungan, akun, dan runtime browser opsional semuanya terhubung dengan benar. Verifikasi integrasi secara bertahap:
get_supported_captchas untuk memeriksa eksekusi alat tanpa membuka browser.get_balance untuk memastikan kunci API tersedia untuk server.detect_captchas atau solve_on_page.Dokumentasi Layanan MCP resmi berisi deskripsi alat saat ini, bendera baris perintah, format konfigurasi, dan persyaratan browser. Repositori CapSolver MCP publik berisi sumber, riwayat perubahan, perintah pengembangan, pelacak masalah, dan lisensi MIT. Halaman paket PyPI berisi file paket yang diterbitkan dan ketersediaan versi.
CapSolver MCP Server adalah satu titik masuk ke tumpukan otomasi agen yang lebih luas. Pilih halaman integrasi yang sesuai dengan kerangka atau runtime browser yang sudah digunakan oleh alur kerja:
| Integrasi | Kapan digunakan |
|---|---|
| Integrasi MCP | Hubungkan klien AI yang kompatibel dengan MCP ke lima alat CapSolver yang dijelaskan dalam artikel ini |
| Integrasi LangChain | Tambahkan alat CapSolver ke alur kerja agen LangChain atau LangGraph |
| Integrasi Browser Use | Tambahkan penanganan CAPTCHA ke jalur otomasi Browser Use |
| Integrasi SDK Agens OpenAI | Ekspos kemampuan CapSolver sebagai alat di dalam alur kerja SDK Agens OpenAI |
| Integrasi Playwright | Bekerja langsung dengan halaman browser dan otomasi berbasis Playwright |
Halaman integrasi menyediakan panduan tingkat produk, sementara capsolver-mcp, capsolver-agent, dan capsolver-core menyediakan paket yang dapat diinstal, kode sumber, contoh, dan pelacak masalah.
CapSolver MCP Server menyediakan alat; itu tidak menentukan apakah tugas otomasi diizinkan. Pengguna tetap bertanggung jawab atas hukum yang berlaku, ketentuan situs, izin akun, persyaratan penanganan data, dan kebijakan organisasi.
Operasi berbasis browser memerlukan Playwright dan instalasi Chromium, sementara alat mode token tidak menjalankan browser. Klien MCP yang kompatibel juga diperlukan: menginstal paket tidak menambahkan dukungan MCP ke aplikasi yang tidak memiliki protokol tersebut.
Paket saat ini ditandai sebagai Alpha dalam metadata proyek Python-nya. Memasang versi yang telah diuji sesuai untuk lingkungan yang terkendali, dan tim harus meninjau changelog sebelum pemutakhiran. Transport jaringan memerlukan perlindungan operasional tambahan karena mengubah batas kepercayaan dari proses anak lokal ke layanan yang dapat diakses.
CapSolver MCP Server menyediakan cara standar untuk membuat lima kemampuan CapSolver tersedia bagi klien AI yang kompatibel dengan MCP. Paket diinstal melalui PyPI, mendukung transport lokal dan jaringan, menjaga dependensi browser opsional, dan mengekspos jalur konfigurasi yang didokumentasikan untuk alat pengembangan MCP utama.
Mulai dengan konfigurasi stdio lokal, pastikan penemuan alat dan akses akun, lalu uji alur kerja yang terbatas dalam lingkungan yang diizinkan. Tinjau sumber paket dan laporkan masalah teknis melalui pelacak masalah GitHub proyek.
Mulai dari halaman integrasi MCP CapSolver, ikuti panduan Layanan MCP, dan tinjau implementasinya di repositori GitHub capsolver-mcp. Gunakan CapSolver hanya untuk otomasi yang sah, diizinkan, dan alur kerja data publik yang disetujui.
Q: Apa itu CapSolver MCP Server?
CapSolver MCP Server adalah paket Python yang mengekspos lima kemampuan CapSolver sebagai alat melalui Model Context Protocol. Klien AI yang kompatibel dapat menemukan dan memanggil alat-alat tersebut setelah server dikonfigurasi.
Q: Apakah saya perlu menginstal capsolver-core secara terpisah?
Tidak. Paket capsolver-mcp yang dipublikasikan menyatakan capsolver-core sebagai ketergantungan runtime, jadi instalasi pip biasa akan menginstalnya secara otomatis. Alat browser masih memerlukan ekstra browser opsional dan Chromium.
P: Versi Python apa saja yang didukung?
CapSolver MCP Server saat ini memerlukan Python 3.10 atau lebih baru, dan metadata proyek mencantumkan Python 3.10, 3.11, 3.12, dan 3.13.
P: Apakah setiap alat memerlukan Playwright?
Tidak. Hanya detect_captchas dan solve_on_page yang memerlukan dukungan browser. Penyelesaian token, pemeriksaan saldo, dan penemuan jenis yang didukung bekerja dengan paket dasar.
P: Apakah CapSolver MCP Server dapat dipaparkan sebagai layanan jarak jauh?
Ya. Server mendukung SSE dan HTTP Streamable tambahan dari stdio lokal, tetapi pengeksposan jarak jauh memerlukan otentikasi yang tepat, TLS, aturan firewall, manajemen rahasia, dan pencatatan akses.
Pilih antara agen AI, skrip, dan otomatisasi web hibrid berdasarkan ketidakpastian tugas, kemampuan pengujian, biaya, dan kontrol yang diperlukan untuk eksekusi yang andal.

Evaluasi layanan CAPTCHA perusahaan dengan uji coba terfokus yang mencakup kesesuaian tugas, hasil yang diterima, pengalokasian biaya, bukti keamanan, dan dukungan.
