تشغيل خادم solvethree MCP في Docker

احفظ هذا باسم Dockerfile. يثبّت الحزمة الرسمية على Node 22، وينتقل إلى المستخدم node الذي لا يملك صلاحيات الجذر، ويشغّل solvethree-mcp كنقطة دخول للحاوية. أوامر البناء والتشغيل مُدرجة أدناه.

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

قبل تشغيلها، اضبط SOLVETHREE_API_KEY على مفتاح API لمساحة عملك وSOLVETHREE_PROXY على وكيلك، في البيئة التي تشغّل Docker. يمرّر كل -e NAME متغيرًا موجودًا؛ ولا يوفّر قيمة له. أبقِ بيانات الاعتماد خارج Dockerfile والصورة.

تُبنى الصورة محليًا باسم solvethree-mcp-local؛ ولا تحتاج إلى حساب Docker Hub. لا يؤدي تشغيلها إلى إنشاء نقطة نهاية MCP مستضافة أو إضافة أتمتة للمتصفح.

هيّئ خادم stdio في مضيف MCP. استخدم Docker بوصفه الأمر، وليس solvethree-mcp: فنقطة دخول الصورة تشغّل الملف التنفيذي داخل الحاوية.

لا تضف -t. يحتاج المضيف إلى stdin وstdout للحاوية من أجل JSON-RPC. يزيل --rm الحاوية عند انتهائها.

يجب أن يكون كلا متغيرَي البيئة متاحًا لعملية مضيف MCP. لن يفيد ضبطهما في طرفية مضيفًا شُغّل من مكان آخر، ما لم يرثهما ذلك المضيف. إذا كان المضيف يقيّد تمرير متغيرات البيئة، فاسمح بكلا الاسمَين.

لتهيئة TOML بنمط Codex، استخدم جدول mcp_servers.solvethree مع الأمر والوسائط أعلاه. أدرج اسمَي المتغيرَين في env_vars، واضبط startup_timeout_sec على 60 وtool_timeout_sec على 100. راجع وثائق تكامل MCP للاطّلاع على العقد الأساسي للخادم.

1. 1.

   تحقّق من الأدوات المتاحة

   استدعِ solvethree_capabilities بعد الاتصال. يوفّر الخادم أدوات الحل واسترجاع المهام؛ ولا يتحكّم في متصفح أو يملأ النماذج.

2. 2.

   جهّز ملف تعريف reCAPTCHA

   بالنسبة إلى reCAPTCHA، أعدّ ملف تعريف نشطًا في ملفات تعريف المواقع قبل طلب الحل. طابق اسم المضيف وإجراء الالتقاط ونوع reCAPTCHA؛ ولا تفترض أن ملف تعريف واحدًا للنطاق يغطي كل الإجراءات. لا يؤدي إرسال مهمة إلى إنشاء ملف تعريف. يشرح دليل إعداد ملف التعريف هذا المتطلب المسبق.

3. 3.

   أنشئ مهمة منطقية واحدة

   استدعِ solvethree_create_recaptcha باستخدام site وaction وrequestId؛ أما recaptchaType وwaitMs فاختياريان. تقرأ هذه الأداة إعداد الوكيل الوحيد من SOLVETHREE_PROXY. ينشئ كل استدعاء إنشاء مهمة واحدة على الأكثر. إذا انتهت مهلة الإنشاء، فأعِد استخدام معرّف الطلب نفسه مع المدخلات نفسها لاستعادة المهمة الموجودة بدلًا من إنشاء مهمة أخرى.

4. 4.

   انتظر نتيجة قابلة للاستخدام

   إذا كانت حالة المهمة pending أو solving، فاسترجعها باستخدام solvethree_get_task. وحدها الحالة ready تحتوي على حل قابل للاستخدام. عند الحالة failed، توقّف عن الاستقصاء وافحص errorCode وerror قبل تحديد ما يجب تغييره.

5. 5.

   أرسل من تطبيقك

   بالنسبة إلى reCAPTCHA، أرسل solution.token، وليس معرّف المهمة. استخدم الهوية المُعادة في userAgent وsecChUa مع الوكيل الذي نجح الحل عبره. تعني المهمة الجاهزة أنه تم توليد حل، وليس أن الهدف قبل طلب تطبيقك.

يتلقى مضيف MCP بيانات الحل الخاصة. أبقِ تلك النتائج خارج السجلات المشتركة؛ ويظل تطبيقك مسؤولًا عن إرسالها إلى الهدف المقصود.