solvethree MCP sunucusunu Docker'da çalıştırın

Bunu Dockerfile olarak kaydedin. Resmî paketi Node 22 üzerine kurar, root olmayan node kullanıcısına geçer ve kapsayıcının giriş noktası olarak solvethree-mcp aracını başlatır. Derleme ve çalıştırma komutları aşağıda verilmiştir.

FROM node:22.23.4-alpine
RUN npm install --global https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz
USER node
ENTRYPOINT ["solvethree-mcp"]

# Build: docker build -t solvethree-mcp-local .
# Forward variables already set in the host; do not add their values to this file.
# Run: docker run --rm -i -e SOLVETHREE_API_KEY -e SOLVETHREE_PROXY solvethree-mcp-local

Çalıştırmadan önce Docker'ı başlatan ortamda SOLVETHREE_API_KEY değişkenini çalışma alanınızın API anahtarına, SOLVETHREE_PROXY değişkenini ise proxy'nize ayarlayın. Her -e NAME, mevcut bir değişkeni aktarır; bir değer sağlamaz. Kimlik bilgilerini Dockerfile'a ve imaja dahil etmeyin.

İmaj, yerel olarak solvethree-mcp-local adıyla derlenir; Docker Hub hesabı gerekmez. Çalıştırılması, barındırılan bir MCP uç noktası oluşturmaz veya tarayıcı otomasyonu eklemez.

MCP ana uygulamanızda bir stdio sunucusu yapılandırın. Komut olarak solvethree-mcp değil, Docker kullanın: imajın giriş noktası, kapsayıcının içindeki yürütülebilir dosyayı başlatır.

-t eklemeyin. Ana uygulama, JSON-RPC için kapsayıcının stdin ve stdout akışlarına ihtiyaç duyar. --rm, kapsayıcı sonlandığında onu kaldırır.

Her iki ortam değişkeni de MCP ana uygulaması sürecinin erişimine açık olmalıdır. Bunları bir terminalde ayarlamak, başka bir yerden başlatılan ana uygulama bu değişkenleri devralmadıkça işe yaramaz. Ana uygulama ortam değişkenlerinin aktarımını kısıtlıyorsa her iki ada da izin verin.

Codex tarzı bir TOML yapılandırması için yukarıdaki komut ve argümanlarla mcp_servers.solvethree tablosunu kullanın. Her iki değişken adını da env_vars içine ekleyin, startup_timeout_sec değerini 60 ve tool_timeout_sec değerini 100 olarak ayarlayın. Temel sunucu sözleşmesi için MCP entegrasyonu belgelerine bakın.

1. 1.

   Kullanılabilir araçları kontrol edin

   Bağlandıktan sonra solvethree_capabilities aracını çağırın. Sunucu, çözüm araçlarını ve görev alma işlevini sunar; bir tarayıcıyı yönetmez veya form doldurmaz.

2. 2.

   reCAPTCHA profilini hazırlayın

   reCAPTCHA için çözüm istemeden önce Site profilleri bölümünde etkin bir profil oluşturun. Ana makine adını, yakalama eylemini ve reCAPTCHA türünü eşleştirin; tek bir alan adı profilinin her eylemi kapsadığını varsaymayın. Görev göndermek profil oluşturmaz. Profil kurulum kılavuzu bu ön koşulu açıklar.

3. 3.

   Tek bir mantıksal görev oluşturun

   solvethree_create_recaptcha aracını site, action ve bir requestId ile çağırın; recaptchaType ve waitMs isteğe bağlıdır. Bu araç, kullandığı tek proxy'yi SOLVETHREE_PROXY değişkeninden okur. Her oluşturma çağrısı en fazla bir görev oluşturur. Oluşturma işlemi zaman aşımına uğrarsa başka bir görev oluşturmak yerine mevcut görevi kurtarmak için aynı istek kimliğini değişmeyen girdilerle yeniden kullanın.

4. 4.

   Kullanılabilir bir sonuç bekleyin

   Görev pending veya solving durumundaysa solvethree_get_task ile alın. Yalnızca ready durumu kullanılabilir bir çözüm içerir. Durum failed olduğunda sorgulamayı durdurun ve neyi değiştireceğinize karar vermeden önce errorCode ve error alanlarını inceleyin.

5. 5.

   Uygulamanızdan gönderin

   reCAPTCHA için görev kimliğini değil, solution.token değerini gönderin. Döndürülen userAgent ve secChUa kimliğini başarılı proxy ile kullanın. Bir görevin hazır olması, bir çözüm üretildiği anlamına gelir; hedefin uygulama isteğinizi kabul ettiği anlamına gelmez.

MCP ana uygulaması özel çözüm verilerini alır. Bu sonuçları paylaşılan günlüklere dahil etmeyin; sonuçları amaçlanan hedefe gönderme sorumluluğu uygulamanızda kalır.