vibe MCP (Dark Philosophy)

vibe mcp


以Codex的MCP子代理的身份运行Mistral Vibe CLI。此服务器封装了Vibe编程模式(-p)并暴露：

• vibe_run：运行新的Vibe任务
• vibe_resume：使用最后一个会话ID恢复项目
• vibe_manage：检查/安装/更新Vibe CLI运行时

需求

• Node.js 18+
• Vibe命令行界面

安装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/config.toml)

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

更改后重新启动Codex。

放大器(~/.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通用公共许可证v3.0