VibeLens

Name: VibeLens
Author: klewicki7

@klewicki7MCP server · External

VibeLens MCP tool for AI to visualize code changes with inline annotations in VS Code/Cursor

Code reviewv0.1.0TypeScript

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npmvibelens-mcpv0.1.0

Run

npx -y vibelens-mcp

MCP client config

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

README2 min readView on GitHub

VibeLens

AI peer review for your code changes.

Just like humans review each other's PRs, your AI reviews its own changes with inline annotations that appear directly in a VS Code/Cursor panel.

Why AI Peer Review?

When humans write code, we do peer review. When AI writes code, we often scroll through chat hoping we understood what changed.

VibeLens gives AI the same workflow humans use: review the diff, annotate the changes, and explain the reasoning next to the code.

How It Works

text

AI makes changes -> AI reviews its own diff -> VibeLens opens an annotated panel

The AI calls the show_diff_explanation MCP tool after completing a task. The MCP server stores the review locally, and the VS Code/Cursor extension renders the diff with inline annotations.

Action buttons let you send improvement suggestions directly to Cursor chat.

Features

Visual diff: Side-by-side or unified view powered by diff2html.
Inline annotations: Review comments appear directly after relevant code lines.
Action buttons: Click to send prompts to Cursor chat, such as refactors or test suggestions.
Click to open: File names link directly to the source.
Workspace-aware: Only shows in the window matching your project.
Auto-configured MCP: The extension configures vibelens-mcp for supported AI tools.

Installation

VS Code

Install kevcode.vibelens-extension from the Visual Studio Marketplace once published.

Cursor

Install kevcode.vibelens-extension from Cursor's extension marketplace once the Open VSX listing syncs.

VSIX

Download the .vsix from GitHub Releases and install it from the Extensions view with "Install from VSIX...".

The extension automatically configures the MCP server on first activation where supported.

Manual MCP Configuration

If auto-configuration does not work, add vibelens-mcp manually to your MCP client.

Cursor

Add to ~/.cursor/mcp.json:

json

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

Claude Desktop

Add to claude_desktop_config.json:

json

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

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

json

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

Packages

Package	Description
packages/extension	VS Code/Cursor extension that displays diff explanations
packages/mcp	MCP server with the `show_diff_explanation` tool

Architecture

text

MCP Server                    VS Code/Cursor Extension
     |                              |
     | writes review data           | watches
     | ~/.vibelens/                 | ~/.vibelens/
     |                              |
     +----------------------------->|
                                    |
                                    v
                              Webview Panel
                         (diff + annotations)

Development

bash

# Install dependencies
pnpm install

# Build all packages
pnpm run build

# Build extension only
pnpm run build:extension

# Build MCP only
pnpm run build:mcp

# Package extension as .vsix
pnpm --filter vibelens-extension package

Publishing

Extension: Published as kevcode.vibelens-extension to VS Code Marketplace and Open VSX.
MCP package: Published to npm as vibelens-mcp.
MCP Registry: Registered as io.github.klewicki7/vibelens-mcp.

License

MIT

Similar modules

Browse Code review