Документация/Локальный MCP

Локальный MCP

VibeBasket через CLI поднимает локальный stdio MCP-сервер, чтобы AI IDE могли искать элементы каталога, понимать возможности целей, планировать установку и применять bundle, не выходя из диалога.

Команда запуска

npx vibebasket mcp serve

Запускайте локальный MCP-сервер командой npx vibebasket mcp serve. Клиент должен подключаться по stdio, а не по HTTP.

Что умеет сейчас

Это сильная phase-1 MCP-поверхность: поиск по каталогу, lookup по item id, guidance по целям, планирование, apply, список backup’ов, rollback и локальное сохранение/загрузка stack’ов идут через реальный сервисный слой CLI.

Ключевые tools

session.get_state — показывает текущий API base URL, write policy и доступность local/cloud stack’ов
targets.list / targets.get_setup_guide / targets.get_mcp_snippet — показывает возможности целей, guidance по настройке и нативные MCP config fragments для каждого IDE
catalog.search / catalog.get_item — ищет и показывает доверенные записи каталога
install.plan / install.apply — сначала dry-run, затем apply через реальный adapter pipeline
install.list_backups / install.rollback — показывает и восстанавливает локальные backup’ы

Модель безопасности

Low-risk tools запускаются напрямую. Medium- и high-risk tools проходят через policy. Runtime secrets остаются локальными, а MCP-поверхность не делает вид, что cloud stack save уже привязан, если это не так.

Текущие ограничения

Cloud/profile-backed stack save по-прежнему идёт через сайт, а не через local MCP.
На этой фазе MCP-сервер работает только по stdio.
Guidance по целям намеренно консервативен и следует текущей adapter-backed модели установки.

Нативные config snippets

Запрашивайте target-native fragments через targets.get_mcp_snippet. Эти примеры показывают точную merge-форму для нескольких типовых клиентов.

Cursor / JSON

mcpServers

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

Каждый snippet — это merge fragment, а не полный config file. Сохраняйте остальную пользовательскую конфигурацию.

Откройте CLI reference, если нужен весь набор команд, или вернитесь в каталог, чтобы сначала собрать bundle.

Открыть CLI reference Открыть каталог