Vibe MCP

🚀 vibe-mcp

This project allows you to run the Mistral Vibe CLI as an MCP sub - agent from Codex. It wraps Vibe programmatic mode (-p) and provides several useful endpoints:

• vibe_run: Initiate a new Vibe task.
• vibe_resume: Resume a project using the last session ID.
• vibe_manage: Check, install, or update the Vibe CLI runtime.

🚀 Quick Start

To use this project, you need to meet the requirements and then install it. After that, you can configure it according to your needs and start using it.

✨ Features

• Wraps Vibe programmatic mode and exposes useful endpoints.
• Supports auto - detection and updating of Codex / Amp / OpenCode configs.
• Allows session persistence and provides cost summary.

📦 Installation

📦 Official install (recommended)

Run the following command to install:

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

This will:

• Clone or update the project to ~/.local/share/mcp-servers/vibe-mcp.
• Automatically detect and update Codex / Amp / OpenCode configs without creating duplicate entries.

📦 Manual install (clone + configure yourself)

Clone the project to the standard MCP location:

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

If you cloned it elsewhere, running ./install.sh will move it to the standard location and update Codex / Amp / OpenCode configs. If detection fails, refer to the Configuration section below.

Requirements

• Node.js 18+
• Vibe CLI

Install Vibe:

uv tool install --upgrade mistral-vibe

If uv is missing:

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

💻 Usage Examples

💻 Basic Usage

Example tool call payload:

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

Resume a task later:

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

💻 Advanced Usage

Both vibe_run and vibe_resume now support new runtime options:

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

📚 Documentation

📚 Configuration

📚 Codex (~/.codex/config.toml)

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

Restart Codex after making changes.

📚 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
    }
  }
}

📚 Session persistence

• Session IDs are stored per project path in: ~/.local/share/mcp-servers/vibe-mcp/state.json
• vibe_resume uses the last stored session ID for that project.

📚 Cost summary

Each response includes a cost line based on Vibe logs in: ~/.vibe/logs/session/*.json and metadata.stats.session_cost.

Example output:

Cost: 0.0022 EUR | Month: 0.0765 EUR

📚 Optional Configuration

Optional env vars:

• VIBE_BIN: Override the Vibe binary path.
• VIBE_MCP_STATE: Override the state file path.
• VIBE_MCP_AUTO_UPDATE=true: Auto - run update flow before execution.

🔧 Technical Details

🔧 New runtime options (tool args)

Both vibe_run and vibe_resume now support:

• auto_install (boolean): If the binary is missing, try to install it automatically.
• auto_update (boolean): Run the update flow before execution.
• install_method (auto|uv): Installation strategy (auto is uv - only).

📄 License

GNU General Public License v3.0

🚧 Roadmap ideas

• Optional transcript return for deeper debugging.
• Smarter session selection when multiple runs happen in parallel.
• Safer defaults for max_turns and max_price.