Vibe CLI MCP代理服务

一个将Mistral Vibe CLI作为MCP子代理运行的服务,支持任务执行、项目恢复和运行时管理。

  • by DarkPhilosophy
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 DarkPhilosophy/vibe-mcp

使用说明

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