दस्तावेज़/लोकल MCP

लोकल MCP

VibeBasket CLI के माध्यम से एक local stdio MCP server देता है, ताकि AI IDEs catalog items खोज सकें, target capabilities समझ सकें, install plan बना सकें, और conversation छोड़े बिना bundles apply कर सकें.

शुरू करने का command

npx vibebasket mcp serve

Local MCP server को npx vibebasket mcp serve से चलाएँ। Client को HTTP नहीं, stdio के माध्यम से connect करना चाहिए.

यह अभी क्या करता है

यह एक मजबूत phase-1 MCP surface है: catalog search, single item lookup, target guidance, install planning, apply, backup listing, rollback, और local stack save/load सब वास्तविक CLI service layer से चलते हैं.

मुख्य tools

session.get_state — current API base URL, write policy और local/cloud stack availability दिखाता है
targets.list / targets.get_setup_guide / targets.get_mcp_snippet — target capabilities, setup guidance और हर IDE के लिए native MCP config fragments बताता है
catalog.search / catalog.get_item — trusted catalog entries खोजता और दिखाता है
install.plan / install.apply — पहले dry-run, फिर real adapter pipeline के माध्यम से apply
install.list_backups / install.rollback — local backups दिखाता और restore करता है

सुरक्षा मॉडल

Low-risk tools सीधे चलते हैं। Medium और high-risk tools policy-gated हैं। Runtime secrets local रहते हैं, और MCP surface cloud stack save linked न होने पर उसका दिखावा नहीं करता.

मौजूदा सीमाएँ

Cloud/profile-backed stack save अभी भी website के रास्ते चलता है, local MCP के अंदर नहीं.
इस phase में MCP server केवल stdio है.
Target guidance जानबूझकर conservative है और current adapter-backed install model को follow करती है.

Native config snippets

targets.get_mcp_snippet से target-native fragments माँगें। ये examples कुछ representative clients के लिए exact merge shape दिखाते हैं.

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 नहीं। User की बाकी config को सुरक्षित रखें.

पूरी command surface के लिए CLI reference खोलें, या पहले bundle बनाने के लिए catalog पर लौटें.

CLI reference खोलें कैटलॉग खोलें