Dokümanlar/Yerel MCP

Yerel MCP

VibeBasket, CLI üzerinden yerel bir stdio MCP sunucusu açar; böylece AI IDE’ler katalog öğelerini keşfedebilir, hedef yeteneklerini anlayabilir, kurulum planı çıkarabilir ve konuşmadan çıkmadan bundle uygulayabilir.

Başlatma komutu

npx vibebasket mcp serve

MCP sunucusunu yerelde npx vibebasket mcp serve ile çalıştır. İstemci HTTP değil stdio üzerinden bağlanmalı.

Bugün neler yapıyor

Bu güçlü bir phase-1 MCP yüzeyi: katalog arama, öğe inceleme, hedef rehberliği, kurulum planlama, kurulum uygulama, yedek listeleme, rollback ve yerel stack kaydetme/yükleme doğrudan gerçek CLI servis katmanı üzerinden çalışır.

Temel araçlar

session.get_state — mevcut API base URL, write policy ve local/cloud stack durumunu öğrenir
targets.list / targets.get_setup_guide / targets.get_mcp_snippet — hedef yeteneklerini, kurulum rehberini ve her IDE için native MCP config fragment'lerini gösterir
catalog.search / catalog.get_item — güvenilir katalog kayıtlarını arar ve inceler
install.plan / install.apply — önce dry-run plan, sonra gerçek adaptör hattı üzerinden apply
install.list_backups / install.rollback — yerel yedekleri inceler ve geri yükler

Güvenlik modeli

Düşük riskli araçlar doğrudan çalışır. Orta ve yüksek riskli araçlar policy ile korunur. Runtime secret’lar yerelde kalır ve MCP yüzeyi, cloud stack save bağlı değilse bunu varmış gibi göstermez.

Mevcut sınırlamalar

Cloud/profile-backed stack save hâlâ local MCP içinde değil, web sitesi üzerinden yürür.
Bu fazda MCP sunucusu yalnızca stdio çalışır.
Target guidance kasıtlı olarak konservatiftir ve mevcut adaptör destekli kurulum modelini takip eder.

Native config snippet'leri

Yerel MCP'den targets.get_mcp_snippet ile hedefe özel fragment'ler iste. Bu örnekler birkaç temsili istemci için tam merge şeklini gösterir.

Cursor / JSON

mcpServers

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

Her snippet tam config dosyası değil, merge fragment'tir. Kullanıcının mevcut config'inin geri kalanını koru.

Tüm komut yüzeyi için CLI referansını açabilir ya da önce bir bundle oluşturmak için kataloğa dönebilirsin.

CLI referansını aç Kataloğu aç