Vibelens Mcp

VibeLens MCP Server

MCP server that provides the show_diff_explanation tool for visualizing code changes with AI annotations.

Installation

npx -y vibelens-mcp

Or install globally:

npm install -g vibelens-mcp

MCP Configuration

Add to your MCP client configuration:

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

Tool: show_diff_explanation

Displays a git diff with AI-generated annotations in the VibeLens extension panel.

Parameters

Annotation Object

Action Object

Example

{  "title": "Add user authentication",  "summary": "Added JWT middleware and protected API routes.",  "diff": "diff --git a/src/auth.ts b/src/auth.ts\n...",  "workspacePath": "/Users/me/myproject",  "annotations": [    {      "file": "src/auth.ts",      "line": 15,      "explanation": "Extracts and validates JWT token from Authorization header",      "actions": [        {          "label": "Add refresh token",          "prompt": "Add refresh token support to this auth middleware"        }      ]    }  ]}

Prompt: vibelens

The MCP server also provides a prompt with instructions for explaining code changes. Reference it with @vibelens in your chat.

The prompt guides the AI to:

1. Get the diff from conversation context (or run git diff if needed)
2. Analyze and prepare annotations
3. Call show_diff_explanation with appropriate parameters
4. Generate specific, actionable suggestions for each annotation

How It Works

The MCP server writes to ~/.vibelens/pending.json and stores reviews in ~/.vibelens/vibelens.db. The companion VS Code/Cursor extension watches this data and displays the diff in a webview panel.

MCP Server                    Extension     │                            │     │ writes to                  │ watches     │ ~/.vibelens/               │ ~/.vibelens/     │ pending.json               │ pending.json     └────────────────────────────┘

Development

# Buildnpm run build
# The server runs via stdionode dist/index.js

License

MIT