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 许可证。