TinyFish

حول

TinyFish هو تكامل MCP لعامل الويب TinyFish. تمنح نقطة النهاية المستضافة الخاصة به المساعدين المتوافقين مع MCP إمكانية الوصول إلى أتمتة الويب والبحث واستخراج المحتوى وإدارة التشغيل وقدرات جلسات المتصفح عن بُعد. تنشر TinyFish أيضًا حزمة TypeScript مرخصة بموجب MIT، @tiny-fish/mcp، والتي تعمل كخادم وكيل عكسي محلي لخدمة MCP المستضافة بدلاً من تعريف أدوات أو مخططات خاصة بها.

الميزات الرئيسية

• أتمتة المتصفح القائمة على الهدف من خلال run_web_automation و run_web_automation_async، مع فحص وإلغاء التشغيل عبر get_run و list_runs و cancel_run.
• بحث الويب من خلال search، بالإضافة إلى فحص استخدام البحث عبر get_search_usage.
• استخراج المحتوى المُقدم من المتصفح عبر fetch_content، مع بيانات تعريف الاستخدام المتاحة عبر list_fetch_usage.
• جلسات Chrome عن بُعد من خلال create_browser_session و list_browser_sessions و close_browser_session للتحكم المباشر باستخدام Playwright أو Puppeteer أو Selenium.
• أدوات حالة الدفعة والإلغاء لعمليات أتمتة متعددة.
• أتمتة واعية بالملف الشخصي يمكنها إعادة استخدام سياق المتصفح المحفوظ واستخدام بيانات اعتماد TinyFish Vault اختياريًا لسير العمل المصادق عليه المتكرر.

حالات الاستخدام

TinyFish مناسبة للوكلاء الذين يحتاجون إلى التنقل في مواقع الويب من أهداف اللغة الطبيعية، واستخراج محتوى الويب المباشر، والبحث عن المعلومات الحالية، والتفاعل مع النماذج والتطبيقات المصادق عليها، أو تسليم جلسة متصفح عن بُعد إلى إطار أتمتة. أدوات التشغيل غير المتزامن وإدارة التشغيل مفيدة لسير العمل الأطول حيث يجب على الوكيل المتصل بدء العمل والاستقصاء عن الإكمال لاحقًا.

التوافق

الخدمة الأساسية هي نقطة نهاية MCP مستضافة باستخدام Streamable HTTP. توفر وثائق TinyFish الحالية إعدادًا خاصًا بالعميل لـ Codex و Grok و Claude Code و OpenCode و Claude Desktop و ChatGPT و Cursor و Windsurf، وتصف الخدمة بأنها قابلة للاستخدام من مساعدين آخرين متوافقين مع MCP. يكشف الوكيل المحلي الاختياري عن نقطة نهاية MCP HTTP حلقة العودة ويوثق المستودع التكوينات لـ Claude Code و Claude Desktop و Cursor و VS Code وعملاء MCP العامين المستندين إلى URL.

القيود

• يتطلب تدفق MCP المستضاف حساب TinyFish وتفويض OAuth 2.1؛ تنص وثائق TinyFish على أن الحساب يجب أن يكون لديه اشتراك نشط أو أرصدة.
• أدوات البحث وجلب المحتوى مجانية في نموذج التسعير الحالي، بينما تستهلك أتمتة الوكيل وجلسات المتصفح عن بُعد أرصدة TinyFish.
• حزمة @tiny-fish/mcp المحلية هي مجرد وكيل للخدمة المستضافة، لذا فهي لا توفر تطبيقًا غير متصل مستقل لأدوات TinyFish.
• يتطلب الوكيل المحلي Node.js 22 أو أحدث و TINYFISH_API_KEY. يرتبط بحلقة العودة فقط، ولكن أي عملية محلية موثوقة يمكنها الوصول إلى منفذ الاستماع الخاص به يمكنها استدعاء عمليات الأتمتة باستخدام المفتاح المحفوظ في الخادم.
• لا تدعم الخدمة المستضافة صفائف دفع JSON-RPC وفقًا لوثائق الوكيل المحلي.

المصادر

• وثائق MCP الرسمية: https://docs.tinyfish.ai/mcp-integration
• التوثيق: https://docs.tinyfish.ai/authentication
• الأسعار: https://www.tinyfish.ai/pricing
• GitHub: https://github.com/tinyfish-io/tinyfish-mcp-server
• npm: https://www.npmjs.com/package/@tiny-fish/mcp

إعداد MCP

المتطلبات الأساسية

• حساب TinyFish مع اشتراك نشط أو رصيد لاستخدام خدمة MCP المستضافة
• عميل MCP يمكنه الاتصال بخادم MCP HTTP عن بُعد للإعداد المستضاف الموصى به
• Node.js >= 22 فقط عند استخدام البروكسي المحلي الاختياري @tiny-fish/mcp
• مفتاح API لـ TinyFish فقط عند استخدام البروكسي المحلي الاختياري @tiny-fish/mcp

متطلبات الوصول

• يستخدم المصادقة لـ MCP المستضاف OAuth 2.1 في المتصفح
• يتطلب البروكسي المحلي الاختياري TINYFISH_API_KEY عند التشغيل ويرسله إلى الخادم العلوي كـ X-API-Key
• البحث والجلب مجانيان في نموذج التسعير الحالي لـ TinyFish؛ أتمتة الوكيل وجلسات المتصفح تستهلك رصيدًا

التطبيق المساعد أو الإضافة

الاسم: البروكسي المحلي @tiny-fish/mcp رابط التثبيت: https://www.npmjs.com/package/@tiny-fish/mcp

• قم بالتثبيت عالميًا باستخدام: npm install -g @tiny-fish/mcp
• بدلاً من ذلك، يمكنك التشغيل دون تثبيت باستخدام: npx @tiny-fish/mcp
• قم بتعيين TINYFISH_API_KEY في البيئة.
• ابدأ tinyfish-mcp ووجّه عميل MCP إلى http://127.0.0.1:3711/mcp.

اختياري. يوصي المستودع باستخدام نقطة النهاية المستضافة مباشرة عندما يدعم العميل Streamable HTTP عن بُعد. استخدم البروكسي المحلي للعملاء المحليين فقط أو مصادقة مفتاح API في CI والأجهزة غير المزودة بشاشة والبرامج النصية.

إعداد العميل

Claude Code

النقل: http

claude mcp add --transport http tinyfish https://agent.tinyfish.ai/mcp

• قم بتشغيل أمر Claude Code الموثّق لإضافة خادم TinyFish MCP المستضاف.

المصادقة:

• عند الاستخدام الأول، أكمل تدفق TinyFish OAuth 2.1 في المتصفح.

نقطة نهاية مستضافة؛ لا حاجة لعملية TinyFish محلية.

Claude Desktop

النقل: http

{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}

• أضف TinyFish كموصل مخصص باستخدام https://agent.tinyfish.ai/mcp، أو استخدم تكوين الخادم المستند إلى URL الموثّق.
• أعد تشغيل Claude Desktop بعد تعديل التكوين.

المصادقة:

• أكمل تدفق OAuth في المتصفح عندما يطلب Claude Desktop المصادقة.

توصي TinyFish باستخدام URL المستضاف المباشر.

Cursor

النقل: http

{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}

• أضف إدخال TinyFish الموثّق إلى إعدادات MCP في Cursor.

المصادقة:

• أكمل TinyFish OAuth 2.1 في المتصفح عند الطلب.

نقطة نهاية مستضافة.

Codex

النقل: http

codex mcp add tinyfish --url https://agent.tinyfish.ai/mcp

• قم بتشغيل أمر Codex الموثّق لإضافة TinyFish.

المصادقة:

• أكمل TinyFish OAuth 2.1 عندما يطلب العميل الإذن.

نقطة نهاية مستضافة.

Windsurf

النقل: http

{
  "mcpServers": {
    "tinyfish": {
      "serverUrl": "https://agent.tinyfish.ai/mcp"
    }
  }
}

• أضف إدخال خادم TinyFish الموثق إلى تكوين MCP الخاص بـ Windsurf.

المصادقة:

• أكمل عملية OAuth 2.1 الخاصة بـ TinyFish في المتصفح عندما يُطلب منك ذلك.

نقطة نهاية مستضافة.

VS Code

النقل: http

{
  "servers": {
    "tinyfish": {
      "type": "http",
      "url": "http://127.0.0.1:3711/mcp"
    }
  }
}

• ابدأ تشغيل الوكيل المحلي الاختياري @tiny-fish/mcp.
• استخدم تكوين .vscode/mcp.json الموثق في المستودع والذي يشير إلى http://127.0.0.1:3711/mcp.

يوثق المستودع هذا الإعداد للوكيل المحلي الخاص بـ VS Code. لم يتم توثيق تكوين مستضاف حالي خاص بـ VS Code على صفحة تكامل TinyFish MCP.

Lovable

لم يتم توثيق إعداد TinyFish MCP العام الخاص بـ Lovable.

أخرى

النقل: http

• قم بتكوين نقطة نهاية MCP المستضافة https://agent.tinyfish.ai/mcp باستخدام إعدادات خادم HTTP القابلة للبث عن بُعد الخاصة بالعميل.

المصادقة:

• أكمل عملية OAuth 2.1 الخاصة بـ TinyFish إذا كان العميل يدعم تدفق المصادقة المستضاف.

يصف توثيق TinyFish نقطة النهاية بأنها قابلة للاستخدام من المساعدات المتوافقة مع MCP ويوثق بشكل منفصل Grok وOpenCode وChatGPT. يختلف بناء الجملة الدقيق للتكوين حسب العميل.

تدفق المصادقة

• أضف https://agent.tinyfish.ai/mcp إلى عميل MCP مدعوم.
• عند الاستخدام الأول، يفتح العميل متصفحًا لمصادقة OAuth 2.1.
• سجل الدخول باستخدام حساب TinyFish وقم بتفويض الاتصال.
• يتم تخزين المصادقة مؤقتًا للجلسات اللاحقة.

متغيرات البيئة

• TINYFISH_API_KEY — مطلوب بواسطة الوكيل المحلي الاختياري
• PORT — منفذ استماع الوكيل المحلي الاختياري؛ القيمة الافتراضية 3711
• TINYFISH_UPSTREAM_URL — تجاوز الوكيل المحلي الاختياري للمسار العلوي؛ القيمة الافتراضية https://agent.tinyfish.ai/mcp

وثائق الإعداد: https://docs.tinyfish.ai/mcp-integration