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 @@
+# Servidores MCP
+
+## ¿Qué es MCP?
+
+El [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) es un estándar abierto que permite a los modelos de IA interactuar con herramientas y fuentes de datos externas. BoosApi actúa como cliente MCP — añades servidores MCP y la IA puede llamar a las herramientas que exponen durante una conversación.
+
+---
+
+## Protocolos de transporte
+
+BoosApi soporta tres protocolos de transporte para comunicarse con servidores MCP:
+
+| Protocolo | Conexión | Caso de uso | Configuración |
+|-----------|---------|------------|---------------|
+| **Stdio** | Proceso local | Herramientas instaladas en tu máquina, lanzadas via `npx`, `uvx`, `python`, etc. | `command` + `args` + `env` opcional |
+| **SSE** | Servidor remoto | Endpoint Server-Sent Events alojado en una máquina remota | `url` |
+| **StreamableHTTP** | Servidor remoto | Endpoint HTTP streaming, alternativa más nueva a SSE | `url` |
+
+---
+
+## Añadir servidores MCP
+
+### Creación por formulario
+
+1. Ve a **Configuración → Servidores MCP**.
+2. Haz clic en **Añadir servidor MCP**.
+3. Introduce un nombre y selecciona el protocolo de transporte.
+4. Completa los campos para tu protocolo elegido.
+5. Haz clic en **Guardar**.
+
+### Importación JSON
+
+Haz clic en **Importar JSON** y pega un objeto de configuración:
+
+```json
+{
+  "mcpServers": {
+    "fetch": {
+      "command": "uvx",
+      "args": ["mcp-server-fetch"]
+    }
+  }
+}
+```
+
+---
+
+## Herramientas integradas
+
+| Herramienta | Descripción |
+|------------|-------------|
+| **@boosapi/fetch** | Obtener páginas web y recursos HTTP |
+| **@boosapi/search-file** | Buscar archivos en tu sistema de archivos local |
+
+---
+
+## Límite de bucle de herramientas
+
+Settings -> MCP permite configurar el número máximo de iteraciones consecutivas de tool calls para una respuesta MCP. Baja el límite al probar servidores desconocidos o súbelo para workflows que encadenan varias herramientas.
+
+## Próximos pasos
+
+- [Pasarela API](./gateway) — exponer tus proveedores como servidor API local
+- [Inicio rápido](./getting-started) — volver a la guía de inicio rápido