feat(desktop): embed BoosAPI Desktop client as a subproject

Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
2026-06-22 11:32:57 +08:00
parent d9c78ecc73
commit e0a5f57793
2305 changed files with 449355 additions and 0 deletions
@@ -0,0 +1,62 @@
+# خوادم MCP
+
+## ما هو MCP؟
+
+[بروتوكول Model Context Protocol (MCP)](https://modelcontextprotocol.io/) معيار مفتوح يتيح لنماذج AI التفاعل مع الأدوات ومصادر البيانات الخارجية. يعمل BoosApi كعميل MCP — تضيف خوادم MCP ويمكن لـ AI استدعاء الأدوات التي تكشفها خلال المحادثة.
+
+---
+
+## بروتوكولات النقل
+
+| البروتوكول | الاتصال | حالة الاستخدام | التكوين |
+|-----------|---------|--------------|---------|
+| **Stdio** | عملية محلية | أدوات مثبّتة على جهازك، يتم إطلاقها عبر `npx` أو `uvx` أو `python`، إلخ | `command` + `args` + `env` اختياري |
+| **SSE** | خادم بعيد | طرف Server-Sent Events مستضاف على جهاز بعيد | `url` |
+| **StreamableHTTP** | خادم بعيد | طرف HTTP للبث، بديل أحدث لـ SSE | `url` |
+
+---
+
+## إضافة خوادم MCP
+
+### الإنشاء عبر النموذج
+
+1. اذهب إلى **الإعدادات ← خوادم MCP**.
+2. انقر **إضافة خادم MCP**.
+3. أدخل اسماً واختر بروتوكول النقل.
+4. امأ الحقول لبروتوكولك المختار.
+5. انقر **حفظ**.
+
+### استيراد JSON
+
+انقر **استيراد JSON** والصق كائن التكوين:
+
+```json
+{
+  "mcpServers": {
+    "fetch": {
+      "command": "uvx",
+      "args": ["mcp-server-fetch"]
+    }
+  }
+}
+```
+
+---
+
+## الأدوات المدمجة
+
+| الأداة | الوصف |
+|-------|-------|
+| **@boosapi/fetch** | جلب صفحات الويب وموارد HTTP |
+| **@boosapi/search-file** | البحث عن الملفات في نظام الملفات المحلي |
+
+---
+
+## Tool loop limit
+
+في Settings -> MCP يمكن ضبط الحد الأقصى لعدد consecutive tool-call iterations داخل MCP-enabled response. اخفض الحد عند اختبار unknown servers، وارفعه للـ workflows التي تحتاج chaining لعدة tools.
+
+## الخطوات التالية
+
+- [بوابة API](./gateway) — كشف مزوّديك كخادم API محلي
+- [البدء السريع](./getting-started) — العودة إلى دليل البدء السريع