إعداد الوكيل

Kilobat مع أي عميل MCP

خادم MCP في Kilobat هو أمر stdio محلي، kilobat mcp. يستطيع أي عميل يبدأ خوادم محلية استخدامه دون مفتاح API أو منفذ مفتوح.

أداة سطر الأوامر وخادم MCP مجانيانmacOS 14 أو أحدثتاريخ التحقق: 30 أكتوبر 2026

تثبيت أداة سطر الأوامر

أداة سطر أوامر Kilobat مجانية ومفتوحة المصدر وتتضمن خادم MCP. ثبّتها باستخدام Homebrew:

brew install seifip/kilobat/kilobat

تحقق باستخدام kilobat --version. يبيّن kilobat doctor ما إذا كان تطبيق Kilobat يعمل ومرشح الشبكة مفعّلًا وPro نشطًا؛ تعمل الأدوات دون التطبيق الذي يضيف أسماء Wi-Fi والسجل وتطبيق القواعد. تتطلب أداة سطر الأوامر macOS 14 أو أحدث.

ربط خادم MCP

شغّل خلفية الوكيل وKilobat على جهاز Mac الذي تريد فحصه. لا يستطيع مشغّل سحابي أو خادم Linux أو حاوية استخدام هذا الأمر المحلي لفحص Mac الخاص بك.

  1. وجّه عميلك إلى هذا الأمر. يتحدث MCP عبر stdin وstdout.

    kilobat mcp
  2. يقرأ معظم العملاء كائن mcpServers مثل هذا:

    {
      "mcpServers": {
        "kilobat": {
          "command": "kilobat",
          "args": [
            "mcp"
          ]
        }
      }
    }
  3. يضيفه Grok Build CLI مثلًا بأمر واحد:

    grok mcp add kilobat -- kilobat mcp

قد لا يرى التطبيق المفتوح من Dock متغير PATH الذي يستخدمه shell. إذا لم يبدأ الخادم، فاستبدل kilobat بالمسار الكامل الذي يطبعه command -v kilobat: وهو /opt/homebrew/bin/kilobat على Apple silicon و/usr/local/bin/kilobat على Intel.

يعرض الخادم أدوات مع تعليقات توضيحية كاملة (readOnlyHint، destructiveHint، idempotentHint، openWorldHint) ويعيد JSON نفسه الذي تعيده أداة سطر الأوامر. تسرد الوثائق كل الأدوات.

إضافة المهارات

تعلّم تسع مهارات للوكيل قراءة قياسات Kilobat والسؤال قبل تغيير الإعدادات. ثبّتها باستخدام skills.sh الذي يسألك عن الوكلاء المطلوب تثبيتها لهم:

npx skills add seifip/kilobat-skills

لعميل لا يعرفه skills.sh، انسخ المجلدات من github.com/seifip/kilobat-skills إلى المكان الذي يقرأ منه المهارات. كل مهارة مجلد يحتوي على SKILL.md.

مهارة kilobat هي نقطة البداية: تضم قواعد الإعداد والسلامة وتوجّه الوكيل إلى المهارة المناسبة، مثل mac-network-troubleshooting أو mac-agent-runs. اطّلع على المهارات التسع كلها.

جرّب هذه الطلبات

اطلب بكلمات بسيطة. يختار الوكيل الأدوات؛ وهذه هي الأدوات التي يحتاجها كل طلب عادةً.

السؤالأدوات MCP
يبدو الإنترنت بطيئًا. اكتشف السبب وأخبرني بما أصلحه أولًا.diagnose_network, get_status
إشارة Wi-Fi ضعيفة في هذه الغرفة. هل القناة مزدحمة وأي قناة يجب أن يستخدمها الموجّه؟get_wifi, scan_wifi, suggest_wifi_channel
يتعطل npm install عند registry.npmjs.org. حدّد الطبقة التي تفشل.diagnose_connection
ما الذي استهلك بيانات نقطة الاتصال اليوم، حسب التطبيق؟get_usage_report, get_status
تتقطع مكالمات الفيديو رغم أن اختبارات السرعة تبدو جيدة. افحص ارتفاعات زمن الاستجابة.run_stutter_test, get_nearby_radios
أستخدم نقطة اتصال هاتفي. أي برامج تحديث سيوقفها Kilobat مؤقتًا، وهل ينبغي تفعيل ذلك؟get_conditions, get_updaters, set_updater_pause
ما التطبيقات التي تنتظر الموافقة على الاتصال ومن وقّعها؟list_approvals

ما يمكن للوكيل تغييره وما لا يمكنه

يصنّف خادم MCP في Kilobat كل أداة للقراءة فقط أو لإجراء تغيير، ويطلب وصف كل أداة تغيير من الوكيل الحصول على تأكيدك أولًا. تتضمن مهارة Kilobat القاعدة نفسها: اقرأ بحرية واسأل قبل التغيير.

قياسات للقراءة فقط

  • قياس زمن استجابة Wi-Fi والموجّه والإنترنت وDNS وحركة البيانات لكل تطبيق: diagnose_network، get_status، get_wifi، scan_wifi.
  • تحديد الطبقة التي توقف مضيفًا وتتبع المسار ومقارنة محلّلات DNS: diagnose_connection، trace_route، benchmark_dns.
  • قراءة السجل والجلسات والقواعد والموافقات: get_usage_report، list_sessions، list_rules، list_approvals.
  • فحص كل مضيف اتصل به الوكيل والأوامر التي شغّلها، مع البايتات والعلامات: agent_network_log.
  • فحص ارتفاعات زمن الاستجابة باستخدام run_stutter_test الذي يرسل طلبات ping فقط.

يسألك أولًا

  • اختبار سرعة يستخدم حتى 80 MB (run_speedtest؛ وعلى شبكة محسوبة الاستهلاك 10 MB أو أقل)، واختبار شبكة محلية لخمس ثوانٍ (run_lan_test).
  • البحث عن عنوان IP العام باستخدام Cloudflare (get_exit_path مع public_ip).
  • الملفات الشخصية وقواعد التطبيقات والمضيفون المحظورون ووضع التطبيقات الجديدة وحدود البيانات والحصص وتكلفة بيانات الشبكة وإيقاف برامج التحديث مؤقتًا (set_profile، set_app_rule، block_destination، set_new_app_mode، set_budget، set_app_quota، set_network_cost، set_updater_pause).
  • تأجيل رفع تطبيق آخر، مثل Dropbox، حتى الاتصال بشبكة أفضل (hold_upload).
  • DNS، الذي يحميه macOS أيضًا بطلب كلمة مرور المسؤول (set_dns).
  • إبقاء Mac يعمل والغطاء مغلق في كل مرة (keep_awake مع lid_closed). لا يغيّر keep_awake وحده أي إعدادات وينتهي عند انقضاء مدته.

لا يمكنه

  • السماح لتطبيق ينتظر بالاتصال من تلقاء نفسه: يستطيع decide_approval الحظر فورًا، لكن السماح يفتح نافذة موافقة Kilobat لتؤكدها بنفسك.
  • تغيير ظهور AirDrop: يفتح set_airdrop_visibility إعدادات النظام لك.
  • تغيير إعدادات السكون أو إعدادات تطبيق آخر أو أي شيء خارج Kilobat. لا يقرأ الطلبات أو الردود أبدًا.
  • تطبيق القواعد دون تطبيق Kilobat ومرشح شبكته (Pro). بدونهما تُحفظ القواعد ولا تُطبّق، وعلى الوكيل توضيح ذلك.

أبقِ تأكيد العميل مفعّلًا لأدوات التغيير؛ ولا توافق عليها تلقائيًا مطلقًا.

إذا كان الوكيل يستطيع أيضًا تشغيل أوامر shell، تستطيع أداة kilobat تنفيذ ما تفعله أدوات MCP. توضّح المهارات الأوامر التي يمكن تشغيلها بحرية وتلك التي تتطلب السؤال.

تتبّع تشغيل الوكلاء

يمكن لوكيل يملك خطافاته إخبار Kilobat ببدء التشغيل أو انتظاره لك أو انتهائه باستدعاء kilobat agent-event start|working|waiting|done|failed --agent <name> --session <id> --cwd <folder>. لا يطبع شيئًا وينتهي دائمًا بالرمز 0، فلا يعطّل الوكيل؛ أضف --verbose عند تجربته يدويًا. توجد خطافات جاهزة لـ Claude Code وCodex وGemini CLI وCline. دون خطافات يعتمد Kilobat على حركة بيانات الوكيل والمعالج.

المصادر

تم التحقق في 30 أكتوبر 2026. تتغير إعدادات الوكلاء كثيرًا؛ إذا لم تعد خطوة مطابقة، فأخبرنا على عنوان الدعم.

وكلاء آخرون

Claude Code امنح Claude Code أدوات لشبكة Mac: حركة البيانات لكل تطبيق وWi-Fi وDNS وأسباب فشل المضيف وإبقاء الجهاز مستيقظًا. إعداد Claude Code ← Codex CLI يمكن لـ Codex فحص الشبكة قبل تنزيل كبير، وتحديد سبب تعليق طلبه، وإبقاء Mac مستيقظًا لمهمة طويلة. إعداد Codex CLI ← Cursor دع وكيل Cursor يعرف سبب تعليق تنزيل حزمة، والتطبيق الذي يستخدم الاتصال، وما إذا كانت الشبكة محسوبة الاستهلاك قبل تنزيل كبير. إعداد Cursor ← Gemini CLI يستطيع Gemini CLI تشخيص شبكة Mac وفحص Wi-Fi وإبقاء Mac مستيقظًا أثناء عمله. إعداد Gemini CLI ← Claude Desktop اسأل Claude عن سبب بطء Wi-Fi أو ما استهلك بيانات نقطة الاتصال أو ما إذا كان VPN يحمل كل حركة البيانات، وسيقرأ الإجابة من Mac. إعداد Claude Desktop ← Windsurf يستطيع Cascade معرفة سبب تعذر تنزيل اعتماد، وفحص DNS وتتبع مسار من Mac باستخدام خادم MCP من Kilobat. إعداد Windsurf ← Cline يستطيع Cline فحص شبكة Mac وإبقاءه مستيقظًا أثناء عمله. إعداد Cline ← Zed يستطيع وكيل Zed قياس شبكة Mac وتتبع مسار ومقارنة محلّلات DNS عبر خادم MCP من Kilobat. إعداد Zed ← Hermes Agent امنح Hermes Agent قياسات شبكة Mac وتشخيص الاتصال وأدوات إبقاء الجهاز مستيقظًا عبر خادم MCP محلي. إعداد Hermes Agent ← OpenClaw دع OpenClaw يفحص اتصال Mac واستخدام البيانات باستخدام أدوات MCP المحلية ومهارات Kilobat. إعداد OpenClaw ← OpenCode يستطيع OpenCode فحص حركة بيانات Mac وشرح الاتصالات الفاشلة وإبقاء الجهاز مستيقظًا للمهام الطويلة باستخدام Kilobat. إعداد OpenCode ← GitHub Copilot CLI يستطيع Copilot CLI فحص عرض النطاق وDNS والتنزيلات الفاشلة على Mac باستخدام خادم MCP المحلي من Kilobat. إعداد GitHub Copilot CLI ←