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,64 @@
+# MCP-серверы
+
+## Что такое MCP?
+
+[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — открытый стандарт, позволяющий ИИ-моделям взаимодействовать с внешними инструментами и источниками данных. BoosApi выступает как MCP-клиент — вы добавляете MCP-серверы, и ИИ может вызывать предоставляемые ими инструменты во время разговора.
+
+---
+
+## Транспортные протоколы
+
+BoosApi поддерживает три транспортных протокола для связи с MCP-серверами:
+
+| Протокол | Соединение | Сценарий использования | Конфигурация |
+|---------|-----------|----------------------|-------------|
+| **Stdio** | Локальный процесс | Инструменты на вашей машине, запускаемые через `npx`, `uvx`, `python` и т.д. | `command` + `args` + опциональный `env` |
+| **SSE** | Удалённый сервер | Server-Sent Events endpoint на удалённой машине | `url` |
+| **StreamableHTTP** | Удалённый сервер | HTTP-потоковый endpoint, более новая альтернатива 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** | Поиск файлов в локальной файловой системе |
+
+---
+
+## Лимит циклов инструментов
+
+В Settings -> MCP можно настроить максимальное число последовательных tool-call iterations для MCP-enabled response. Уменьшайте лимит при тестировании неизвестных серверов или увеличивайте его для workflow, где несколько tools должны выполняться цепочкой.
+
+## Следующие шаги
+
+- [API-шлюз](./gateway) — предоставление провайдеров как локального API-сервера
+- [Быстрый старт](./getting-started) — вернуться к руководству по быстрому старту