文档/本地 MCP

本地 MCP

VibeBasket 通过 CLI 暴露一个本地 stdio MCP 服务，让 AI IDE 可以在不离开对话的情况下发现目录条目、理解目标能力、规划安装并应用 bundle。

启动命令

npx vibebasket mcp serve

使用 npx vibebasket mcp serve 在本地启动 MCP 服务。客户端应通过 stdio 连接，而不是 HTTP。

当前能力

这是一个扎实的 phase-1 MCP 面：目录搜索、单项查询、目标指导、安装规划、应用、备份列表、rollback，以及本地 stack 的保存与加载，都复用了真实的 CLI 服务层。

关键工具

session.get_state — 查看当前 API base URL、写策略与本地/云 stack 可用性
targets.list / targets.get_setup_guide / targets.get_mcp_snippet — 查看目标能力、接入指导与每个 IDE 的原生 MCP 配置片段
catalog.search / catalog.get_item — 搜索并查看可信目录条目
install.plan / install.apply — 先 dry-run，再通过真实 adapter 管线 apply
install.list_backups / install.rollback — 查看并恢复本地备份

安全模型

低风险工具可直接运行。中高风险工具受 policy 保护。Runtime secrets 保持在本机，本地 MCP 也不会假装 cloud stack save 已接通。

当前限制

Cloud/profile-backed stack save 仍在网站路径中，不在本地 MCP 内。
当前阶段 MCP 服务仅支持 stdio。
目标指导刻意保持保守，遵循当前 adapter 支持的安装模型。

原生配置片段

通过 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 片段，不是完整配置文件。请保留用户现有配置的其余部分。

如果你想看完整命令面，请打开 CLI 文档；或者先回到目录构建一个 bundle。

打开 CLI 文档打开目录