---
title: "Kilobat في Gemini CLI: خادم MCP في settings.json والمهارات والخطافات | Kilobat"
url: "https://kilobat.app/ar/agents/gemini-cli"
description: "اربط خادم MCP في Kilobat بـ Gemini CLI باستخدام gemini mcp add أو ~/.gemini/settings.json، وأضف مهارات الوكيل وأرسل حالات التشغيل إلى Kilobat بالخطافات."
---

إعداد الوكيل

# إعداد Kilobat في Gemini CLI

يستطيع Gemini CLI تشخيص شبكة Mac وفحص Wi-Fi وإبقاء Mac مستيقظًا أثناء عمله. تخبر خطافاته Kilobat أي تشغيل يعمل وأيّها ينتظرك.

أداة سطر الأوامر وخادم 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. أضف الخادم لمستخدمك. دون `-s user` يوضع في `.gemini/settings.json` للمشروع الحالي.

   ```
   gemini mcp add -s user kilobat kilobat mcp
   ```
2. أو أضفه إلى `~/.gemini/settings.json` بنفسك:

   ```
   {
     "mcpServers": {
       "kilobat": {
         "command": "kilobat",
         "args": [
           "mcp"
         ],
         "timeout": 120000
       }
     }
   }
   ```
3. شغّل `gemini mcp list`. في مجلد لم تثق به، تظهر خوادم stdio غير متصلة حتى تشغّل `gemini trust`.

نقلت Google تسجيل دخول الأفراد إلى Gemini CLI إلى Antigravity CLI في يونيو 2026؛ ولا يزال Gemini CLI يتيح خيارات مصادقة أخرى، منها مفاتيح API وVertex AI. ولدى Antigravity CLI إعداداته الخاصة. الإعدادات والخطافات في هذه الصفحة خاصة بـ Gemini CLI.

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

تعلّم تسع مهارات للوكيل كيفية قراءة قياسات Kilobat وطلب الإذن قبل تغيير الإعدادات. ثبّتها لكل مشاريعك باستخدام [skills.sh](https://skills.sh/seifip/kilobat-skills):

```
npx skills add seifip/kilobat-skills -g -a gemini-cli
```

يضعها هذا في `~/.gemini/skills/`. احذف `-g` لتثبيتها للمشروع الحالي فقط، أو احذف الخيارين لاختيار الوكلاء من قائمة.

مهارة `kilobat` هي نقطة البداية: تضم قواعد الإعداد والسلامة وتوجّه الوكيل إلى المهارة المناسبة، مثل `mac-network-troubleshooting` أو `mac-agent-runs`. اطّلع على [المهارات التسع كلها](https://kilobat.app/ar/docs/agents#network-troubleshooting-skill).

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

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

| السؤال | أدوات MCP |
|---|---|
| يبدو الإنترنت بطيئًا. اكتشف السبب وأخبرني بما أصلحه أولًا. | `diagnose_network`, `get_status` |
| إشارة Wi-Fi ضعيفة في هذه الغرفة. هل القناة مزدحمة وأي قناة يجب أن يستخدمها الموجّه؟ | `get_wifi`, `scan_wifi`, `suggest_wifi_channel` |
| يتعطل npm install عند registry.npmjs.org. حدّد الطبقة التي تفشل. | `diagnose_connection` |
| أبقِ Mac مستيقظًا للساعتين القادمتين أثناء تشغيل مجموعة الاختبارات الكاملة، ثم ألغِ الإبقاء عليه مستيقظًا. | `keep_awake`, `release_awake` |
| هل انتهت عمليات تشغيل الوكيل اليوم أم تعثرت إحداها أو فقدت الشبكة؟ | `list_sessions` |
| شغّل اختبار سرعة بحجم 10 MB وأخبرني إن كانت مكالمة الفيديو ستصمد. | `run_speedtest` |

## ما يمكن لـ Gemini CLI تغييره وما لا يمكنه

يصنّف خادم MCP في Kilobat كل أداة للقراءة فقط أو لإجراء تغيير، ويطلب وصف كل أداة تغيير من الوكيل الحصول على تأكيدك أولًا. تتضمن [مهارة Kilobat](https://github.com/seifip/kilobat-skills/tree/main/skills/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). بدونهما تُحفظ القواعد ولا تُطبّق، وعلى الوكيل توضيح ذلك.

اترك `trust` معطّلًا كما هو افتراضيًا، حتى يؤكد Gemini CLI كل استدعاء لأدوات Kilobat.

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

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

أضف هذه إلى `~/.gemini/settings.json` وادمجها مع أي خطافات لديك. يعمل Gemini CLI باسم `node`، لذا لا يستطيع Kilobat ربط حركة بياناته بالتشغيل، لكن الحالة تصل.

```
{
  "hooks": {
    "SessionStart": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent gemini --stdin-json" }] }],
    "BeforeAgent": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent gemini --stdin-json" }] }],
    "Notification": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent gemini --stdin-json" }] }],
    "AfterAgent": [{ "hooks": [{ "type": "command", "command": "kilobat agent-event --agent gemini --stdin-json" }] }]
  }
}
```

## المصادر

- [وثائق Gemini CLI: خوادم MCP](https://geminicli.com/docs/tools/mcp-server/)
- [وثائق Kilobat: وكلاء الذكاء الاصطناعي وMCP](https://kilobat.app/ar/docs/agents#agents)
- [skills.sh: الوكلاء المدعومون ومجلدات مهاراتهم](https://github.com/vercel-labs/skills/blob/main/docs/agents.md)

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

## وكلاء آخرون

- [Claude Code](https://kilobat.app/ar/agents/claude-code): امنح Claude Code أدوات لشبكة Mac: حركة البيانات لكل تطبيق وWi-Fi وDNS وأسباب فشل المضيف وإبقاء الجهاز مستيقظًا.
- [Codex CLI](https://kilobat.app/ar/agents/codex): يمكن لـ Codex فحص الشبكة قبل تنزيل كبير، وتحديد سبب تعليق طلبه، وإبقاء Mac مستيقظًا لمهمة طويلة.
- [Cursor](https://kilobat.app/ar/agents/cursor): دع وكيل Cursor يعرف سبب تعليق تنزيل حزمة، والتطبيق الذي يستخدم الاتصال، وما إذا كانت الشبكة محسوبة الاستهلاك قبل تنزيل كبير.
- [Claude Desktop](https://kilobat.app/ar/agents/claude-desktop): اسأل Claude عن سبب بطء Wi-Fi أو ما استهلك بيانات نقطة الاتصال أو ما إذا كان VPN يحمل كل حركة البيانات، وسيقرأ الإجابة من Mac.
- [Windsurf](https://kilobat.app/ar/agents/windsurf): يستطيع Cascade معرفة سبب تعذر تنزيل اعتماد، وفحص DNS وتتبع مسار من Mac باستخدام خادم MCP من Kilobat.
- [Cline](https://kilobat.app/ar/agents/cline): يستطيع Cline فحص شبكة Mac وإبقاءه مستيقظًا أثناء عمله.
- [Zed](https://kilobat.app/ar/agents/zed): يستطيع وكيل Zed قياس شبكة Mac وتتبع مسار ومقارنة محلّلات DNS عبر خادم MCP من Kilobat.
- [Hermes Agent](https://kilobat.app/ar/agents/hermes): امنح Hermes Agent قياسات شبكة Mac وتشخيص الاتصال وأدوات إبقاء الجهاز مستيقظًا عبر خادم MCP محلي.
- [OpenClaw](https://kilobat.app/ar/agents/openclaw): دع OpenClaw يفحص اتصال Mac واستخدام البيانات باستخدام أدوات MCP المحلية ومهارات Kilobat.
- [OpenCode](https://kilobat.app/ar/agents/opencode): يستطيع OpenCode فحص حركة بيانات Mac وشرح الاتصالات الفاشلة وإبقاء الجهاز مستيقظًا للمهام الطويلة باستخدام Kilobat.
- [GitHub Copilot CLI](https://kilobat.app/ar/agents/copilot-cli): يستطيع Copilot CLI فحص عرض النطاق وDNS والتنزيلات الفاشلة على Mac باستخدام خادم MCP المحلي من Kilobat.
- [أي عميل MCP](https://kilobat.app/ar/agents/mcp-client): خادم MCP في Kilobat هو أمر stdio محلي، kilobat mcp.