home / mcp / vibewatch mcp server

VibeWatch MCP Server

Provides live terminal visibility to MCP clients for debugging and collaboration.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "krjordan-vibewatch": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "vibewatch",
        "vibewatch-mcp"
      ]
    }
  }
}

VibeWatch is a local bridge that streams your terminal output to an MCP-compatible AI assistant in real time. It lets you monitor commands as you work, so the AI can review errors, context, and recent output without you needing to paste logs manually.

How to use

You wrap any command you run with the VibeWatch launcher to expose terminal output to your MCP client in real time. This lets Claude or any MCP-enabled assistant see live logs, errors, and progress so you can get immediate, context-aware help. You can use it with common dev servers, test runners, or build commands by prefixing them with vibewatch.

How to install

Prerequisites: you need Node.js installed on your system. You should also have npm or yarn for package management.

# Install globally
npm install -g vibewatch

# Or run directly with npx
npx vibewatch npm run dev

# Your dev server runs normally, but now Claude can see it!

Additional setup and usage notes

Optionally configure the MCP client to connect to the local VibeWatch bridge. If you prefer an explicit local process, you can run VibeWatch with its own MCP adapter.

{
  "mcpServers": {
    "vibewatch": {
      "command": "npx",
      "args": ["-y", "-p", "vibewatch", "vibewatch-mcp"]
    }
  }
}

Common commands to run with VibeWatch

Wrap the command you want to observe with vibewatch to start capturing its terminal output for MCP.

# JavaScript/TypeScript projects
vibewatch npm run dev
vibewatch npx next dev
vibewatch yarn dev
vibewatch pnpm dev

# Python projects
vibewatch python manage.py runserver
vibewatch uvicorn main:app --reload
vibewatch pytest

# Others
vibewatch cargo run
vibewatch go run main.go

Security and privacy notes

VibeWatch captures terminal output locally and can surface it to your MCP client. Ensure you only connect trusted MCP clients and understand what data the terminal emits, especially when dealing with sensitive credentials or secrets.

Available tools

get_terminal_output

Fetches recent terminal output with optional filters and details for quick inspection.

get_crash_context

Returns crash details and stack traces to help diagnose failures.

get_recent_errors

Provides a quick view of the most recent errors observed in the terminal stream.

ping

Tests connectivity between the MCP client and the local VibeWatch bridge.