Vibelens Mcp

io.github.klewicki7由 GitHub 账号 klewicki7 发布v0.1.0更新于 Oct 25, 2026

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

已验证STDIO仅桌面开发者工具媒体与设计

概览

AI 生成的概览

一个本地 MCP 服务器，让助手在 VS Code 或 Cursor 的 VibeLens 面板中以带注释的方式展示 git 差异。

可以做什么
在 VibeLens 扩展面板中展示 git 差异，可附带标题、摘要以及按文件或按行的注释，并可指定 Cursor 或 VS Code 以及用于过滤的工作区路径。为单条注释附加带标签和提示词的操作按钮，方便审阅者向聊天发送后续请求。提供一个可复用的提示词，引导助手获取差异、准备注释并调用展示工具。
适用场景
当你希望 AI 对代码改动的解释以可视化方式显示在编辑器中的差异旁边，而不是纯聊天文本时适用，例如在提交前审阅某个分支或工作区改动。
运行要求
通过 stdio 在本地运行，通常用 npx 或全局 npm 安装启动，因此需要 Node.js。需要 VS Code 或 Cursor 中配套的 VibeLens 扩展来显示结果。清单声明需要一个名为 YOUR_API_KEY 的必需 API 密钥环境变量。
安装前请注意
服务器会在用户主目录下写入待处理文件和一个本地数据库，扩展会读取这些数据，因此差异内容和注释会保存在磁盘上。它要求通过 YOUR_API_KEY 提供 API 密钥，提供前请确认该密钥的用途。注释和操作提示词会传给编辑器扩展，点击按钮时可能被发送到聊天。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Vibelens Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

VibeLens MCP Server

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

Installation

bash
npx -y vibelens-mcp

Or install globally:

bash
npm install -g vibelens-mcp

MCP Configuration

Add to your MCP client configuration:

json
{  "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

ParameterTypeRequiredDescription
titlestringYesTitle for the explanation
diffstringYesRaw git diff output (unified format)
summarystringNoHigh-level overview of changes
annotationsarrayNoExplanations for specific parts of the diff
workspacePathstringNoAbsolute path to project folder (for workspace filtering)
editorstringNo"cursor" or "vscode" (default: "cursor")

Annotation Object

FieldTypeRequiredDescription
filestringYesFile path the annotation refers to
linenumberNoLine number in the new file
explanationstringYesYour explanation of this change
actionsarrayNoAction buttons with prompts

Action Object

FieldTypeRequiredDescription
labelstringYesButton label (e.g., "Add tests")
promptstringYesFull prompt to send to chat

Example

json
{  "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

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

License

MIT

来源：packages/mcp/README.md，提交 67b82b4

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。