Vibe MCP

🚀 vibe-mcp

vibe-mcp 可讓你從 Codex 中將 Mistral Vibe CLI 作為 MCP 子代理運行。此服務器封裝了 Vibe 編程模式（-p），並提供以下接口：

• vibe_run：運行新的 Vibe 任務
• vibe_resume：使用最後一個會話 ID 恢復項目
• vibe_manage：檢查/安裝/更新 Vibe CLI 運行時

🚀 快速開始

要使用 vibe-mcp，你需要滿足以下要求：

• Node.js 18+
• Vibe CLI

安裝 Vibe

uv tool install --upgrade mistral-vibe

如果 uv 未安裝，可以使用以下命令進行安裝：

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --upgrade mistral-vibe

📦 安裝指南

官方安裝（推薦）

curl -fsSL https://raw.githubusercontent.com/DarkPhilosophy/vibe-mcp/main/install.sh | bash

此命令將執行以下操作：

• 將項目克隆或更新到 ~/.local/share/mcp-servers/vibe-mcp
• 自動檢測並更新 Codex / Amp / OpenCode 配置（不會添加重複條目）

手動安裝（自行克隆並配置）

將項目克隆到標準 MCP 位置：

git clone https://github.com/DarkPhilosophy/vibe-mcp.git "$HOME/.local/share/mcp-servers/vibe-mcp"

如果你將項目克隆到了其他位置，運行 ./install.sh 會將其移動到標準位置，並更新 Codex / Amp / OpenCode 配置。如果檢測失敗，請參考下面的配置部分。

📚 詳細文檔

配置

Codex (~/.codex/config.toml)

[mcp_servers.vibe]
command = "node"
args = ["$HOME/.local/share/mcp-servers/vibe-mcp/index.js"]
startup_timeout_sec = 30.0

修改後請重啟 Codex。

Amp (~/.config/amp/settings.json)

{
  "amp.mcpServers": {
    "vibe": {
      "command": "node",
      "args": [
        "$HOME/.local/share/mcp-servers/vibe-mcp/index.js"
      ]
    }
  }
}

OpenCode (~/.config/opencode/opencode.json)

{
  "mcp": {
    "vibe": {
      "type": "local",
      "command": [
        "node",
        "$HOME/.local/share/mcp-servers/vibe-mcp/index.js"
      ],
      "enabled": true
    }
  }
}

使用示例

工具調用示例

{
  "prompt": "Summarize this repo in 3 bullets.",
  "project_dir": "$HOME/Projects/cpufetch",
  "max_turns": 8,
  "max_price": 1
}

恢復任務示例

{
  "prompt": "Continue from earlier and list next steps.",
  "project_dir": "$HOME/Projects/cpufetch",
  "max_turns": 5,
  "max_price": 1
}

會話持久化

• 會話 ID 按項目路徑存儲在：~/.local/share/mcp-servers/vibe-mcp/state.json
• vibe_resume 使用該項目最後存儲的會話 ID。

成本總結

每個響應都會根據 Vibe 日誌中的信息包含一個成本行，日誌文件位於：~/.vibe/logs/session/*.json 和 metadata.stats.session_cost。

示例輸出：

Cost: 0.0022 EUR | Month: 0.0765 EUR

配置選項

可選環境變量

• VIBE_BIN：覆蓋 Vibe 二進制文件路徑
• VIBE_MCP_STATE：覆蓋狀態文件路徑
• VIBE_MCP_AUTO_UPDATE=true：在執行前自動運行更新流程

新的運行時選項（工具參數）

vibe_run 和 vibe_resume 現在都支持以下參數：

• auto_install (boolean)：如果二進制文件缺失，嘗試自動安裝
• auto_update (boolean)：在執行前運行更新流程
• install_method (auto|uv)：安裝策略（auto 僅使用 uv）

示例：

{
  "prompt": "Summarize this repo in 3 bullets.",
  "project_dir": "$HOME/Projects/cpufetch",
  "auto_install": true,
  "auto_update": true,
  "install_method": "auto"
}

路線圖設想

• 可選的轉錄返回，以便進行更深入的調試
• 當多個任務並行運行時，實現更智能的會話選擇
• 為 max_turns 和 max_price 設置更安全的默認值

📄 許可證

本項目採用 GNU General Public License v3.0 許可證。