إعداد الوكيل
إعداد Kilobat في Claude Code
امنح Claude Code أدوات لشبكة Mac: حركة البيانات لكل تطبيق وWi-Fi وDNS وأسباب فشل المضيف وإبقاء الجهاز مستيقظًا. تخبر خطافاته Kilobat إن كان التشغيل يعمل أو ينتظرك أو انتهى.
تثبيت أداة سطر الأوامر
أداة سطر أوامر Kilobat مجانية ومفتوحة المصدر وتتضمن خادم MCP. ثبّتها باستخدام Homebrew:
brew install seifip/kilobat/kilobatتحقق باستخدام kilobat --version. يبيّن kilobat doctor ما إذا كان تطبيق Kilobat يعمل ومرشح الشبكة مفعّلًا وPro نشطًا؛ تعمل الأدوات دون التطبيق الذي يضيف أسماء Wi-Fi والسجل وتطبيق القواعد. تتطلب أداة سطر الأوامر macOS 14 أو أحدث.
ربط خادم MCP
شغّل خلفية الوكيل وKilobat على جهاز Mac الذي تريد فحصه. لا يستطيع مشغّل سحابي أو خادم Linux أو حاوية استخدام هذا الأمر المحلي لفحص Mac الخاص بك.
أضف الخادم لكل مشاريعك. يفصل
--خيارات Claude Code عن الأمر الذي يشغّله.claude mcp add --scope user kilobat -- kilobat mcpابدأ جلسة جديدة وشغّل
/mcp. يظهر Kilobat على أنه متصل.
دون --scope user، يُضاف الخادم للمشروع الحالي فقط في ~/.claude.json. ومع --scope project يوضع في .mcp.json الخاص بالمشروع لمشاركته مع فريقك.
إضافة المهارات
تعلّم تسع مهارات للوكيل كيفية قراءة قياسات Kilobat وطلب الإذن قبل تغيير الإعدادات. ثبّتها لكل مشاريعك باستخدام skills.sh:
npx skills add seifip/kilobat-skills -g -a claude-codeيضعها هذا في ~/.claude/skills/. احذف -g لتثبيتها للمشروع الحالي فقط، أو احذف الخيارين لاختيار الوكلاء من قائمة.
مهارة kilobat هي نقطة البداية: تضم قواعد الإعداد والسلامة وتوجّه الوكيل إلى المهارة المناسبة، مثل mac-network-troubleshooting أو mac-agent-runs. اطّلع على المهارات التسع كلها.
جرّب هذه الطلبات
اطلب بكلمات بسيطة. يختار الوكيل الأدوات؛ وهذه هي الأدوات التي يحتاجها كل طلب عادةً.
| السؤال | أدوات MCP |
|---|---|
| يبدو الإنترنت بطيئًا. اكتشف السبب وأخبرني بما أصلحه أولًا. | diagnose_network, get_status |
| يتعطل npm install عند registry.npmjs.org. حدّد الطبقة التي تفشل. | diagnose_connection |
| أنا على وشك تنزيل صورة Docker بحجم 6 GB. هل الوقت مناسب أم أنني على شبكة محسوبة الاستهلاك؟ | get_conditions |
| أبقِ Mac مستيقظًا للساعتين القادمتين أثناء تشغيل مجموعة الاختبارات الكاملة، ثم ألغِ الإبقاء عليه مستيقظًا. | keep_awake, release_awake |
| هل انتهت عمليات تشغيل الوكيل اليوم أم تعثرت إحداها أو فقدت الشبكة؟ | list_sessions |
| هناك شيء يرفع بيانات كثيرة. أي تطبيق هو وكم أرسل في الساعة الماضية؟ | get_status, get_app_bandwidth |
| تتقطع مكالمات الفيديو رغم أن اختبارات السرعة تبدو جيدة. افحص ارتفاعات زمن الاستجابة. | run_stutter_test, get_nearby_radios |
ما يمكن لـ Claude Code تغييره وما لا يمكنه
يصنّف خادم 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). بدونهما تُحفظ القواعد ولا تُطبّق، وعلى الوكيل توضيح ذلك.
يسأل Claude Code قبل استدعاء أداة MCP ما لم تسمح قاعدة أذونات بذلك. لتجاوز الطلب للقراءة فقط، اسمح بالأدوات بالاسم مثل mcp__kilobat__diagnose_network، واترك أدوات التغيير في Kilobat تطلب الإذن.
إذا كان الوكيل يستطيع أيضًا تشغيل أوامر shell، تستطيع أداة kilobat تنفيذ ما تفعله أدوات MCP. توضّح المهارات الأوامر التي يمكن تشغيلها بحرية وتلك التي تتطلب السؤال.
تتبّع تشغيل الوكلاء
أضف هذه إلى ~/.claude/settings.json وادمجها مع أي خطافات لديك. يتلقى كل خطاف JSON عبر stdin يتضمن معرّف الجلسة والمجلد، ويقرأه --stdin-json. طلب الإذن أو الإدخال يعني الانتظار؛ وتعني Stop الانتهاء بعد اكتمال مهام الخلفية؛ ويعني حد المعدل الانتظار حتى إعادة ضبطه.
{
"hooks": {
"SessionStart": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"Notification": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"Stop": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"StopFailure": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }],
"SessionEnd": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent claude --stdin-json" }] }]
}
}المصادر
- وثائق Claude Code: ربط Claude Code بالأدوات عبر MCP
- وثائق Claude Code: مرجع الخطافات
- وثائق Kilobat: وكلاء الذكاء الاصطناعي وMCP
- skills.sh: الوكلاء المدعومون ومجلدات مهاراتهم
تم التحقق في 30 أكتوبر 2026. تتغير إعدادات الوكلاء كثيرًا؛ إذا لم تعد خطوة مطابقة، فأخبرنا على عنوان الدعم.
