Vibe MCP

🚀 vibe - mcp

CodexからMistral Vibe CLIをMCPサブエージェントとして実行します。このサーバーはVibeのプログラムモード (-p) をラップし、以下の機能を公開します。

• vibe_run：新しいVibeタスクを実行する
• vibe_resume：最後のセッションIDを使用してプロジェクトを再開する
• vibe_manage：Vibe CLIランタイムを確認/インストール/更新する

📦 インストール

前提条件

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

高度な使用法

新しいランタイムオプション (ツール引数) の例：

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

vibe_run と vibe_resume は両方とも以下をサポートしています。

• auto_install (boolean)：バイナリがない場合、自動的にインストールを試みます。
• auto_update (boolean)：実行前に更新フローを実行します。
• install_method (auto|uv)：インストール戦略 (auto は uv のみ)。

セッションの永続化

• セッション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：実行前に自動更新フローを実行します。

ロードマップのアイデア

• 詳細なデバッグのためのオプションのトランスクリプト返却
• 複数の実行が並行して行われる場合のより賢いセッション選択
• max_turns と max_price のより安全なデフォルト設定

📄 ライセンス

GNU General Public License v3.0