Docs/MCP local

MCP local

VibeBasket expone un servidor MCP local por stdio desde el CLI para que los AI IDEs descubran elementos del catálogo, entiendan capacidades por objetivo, planifiquen instalaciones y apliquen bundles sin salir de la conversación.

Comando de arranque

npx vibebasket mcp serve

Ejecuta el servidor MCP local con npx vibebasket mcp serve. El cliente debe conectarse por stdio, no por HTTP.

Lo que hace hoy

Es una buena superficie MCP de fase 1: búsqueda de catálogo, lookup por id, guía por objetivo, planificación, apply, listado de backups, rollback y guardado/carga de stacks locales pasan por la misma capa real de servicios del CLI.

Herramientas clave

session.get_state — descubre la API base URL actual, la política de escritura y la disponibilidad de stacks locales/cloud
targets.list / targets.get_setup_guide / targets.get_mcp_snippet — inspecciona capacidades por objetivo, guía de integración y fragmentos nativos de configuración MCP por IDE
catalog.search / catalog.get_item — busca e inspecciona entradas confiables del catálogo
install.plan / install.apply — primero dry-run, luego apply por la tubería real de adapters
install.list_backups / install.rollback — inspecciona y restaura backups locales

Modelo de seguridad

Las herramientas de bajo riesgo corren directamente. Las de riesgo medio o alto quedan protegidas por policy. Los secrets de runtime permanecen locales y la superficie MCP no finge que el guardado cloud está enlazado cuando no lo está.

Limitaciones actuales

El guardado cloud/profile-backed de stacks sigue yendo por el sitio web, no por el MCP local.
En esta fase el servidor MCP es solo stdio.
La guía por objetivo es conservadora y sigue el modelo actual respaldado por adapters.

Snippets nativos de configuración

Pide fragmentos nativos por objetivo con targets.get_mcp_snippet. Estos ejemplos muestran la forma exacta de merge para algunos clientes representativos.

Cursor / JSON

mcpServers

{
  "mcpServers": {
    "vibebasket": {
      "command": "npx",
      "args": [
        "-y",
        "vibebasket",
        "mcp",
        "serve"
      ],
      "env": {
        "VIBEBASKET_API_URL": "https://vibebasket.dev",
        "VIBEBASKET_MCP_WRITE_POLICY": "confirm"
      }
    }
  }
}

Cada snippet es un fragmento de merge, no un archivo de configuración completo. Conserva el resto de la configuración del usuario.

Abre la referencia del CLI si quieres toda la superficie de comandos, o vuelve al catálogo para construir primero un bundle.

Abrir referencia CLI Abrir catálogo