mcpField
V
vibelens-mcp

vibelens-mcp

本地服务
github.com/klewicki7开发工具020 周前更新
代码仓库

关于 vibelens-mcp

vibelens-mcp 是一个 MCP 服务，可在 VibeLens 扩展面板中展示带有 AI 注释的代码差异，适用于使用 VS Code 或 Cursor 审查和解释代码变更的开发者与编码 Agent。

主要功能

  1. 01展示带注释的统一格式 git 差异
  2. 02添加变更摘要和文件级说明
  3. 03包含行级注释与操作按钮
  4. 04提供代码变更说明提示词

适用场景

  1. 01在编辑器中审查代码变更
  2. 02解释差异中的特定代码行
  3. 03提供添加测试等后续操作

MCP 相关

该 MCP 服务提供 `show_diff_explanation` 工具和 `vibelens` 提示词，并写入供配套 VS Code/Cursor 扩展展示的审查数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "klewicki7-vibelens": {
      "command": "npx",
      "args": [
        "-y",
        "vibelens-mcp"
      ],
      "env": {
        "YOUR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}
启动命令npx -y vibelens-mcp
需要配置的环境变量
YOUR_API_KEY密钥Your API key for the service

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmvibelens-mcp0.1.0

工具

1

收录的工具列表 · 更新于 2 周前

参数类型必填说明
diffstring是作为字符串提供的原始 git diff 输出（统一 diff 格式）。重要：请传入实际 diff 内容，而不是文件路径或 shell 命令。
titlestring是说明标题（例如，“添加用户身份验证”）
editorenum否你正在使用的编辑器cursor | vscode
summarystring否更改的概括性摘要
annotationsarray否说明 diff 特定部分的注释
workspacePathstring否工作区／项目文件夹的绝对路径。用于将审查归属到正确的项目。

详细介绍

VibeLens MCP 服务

MCP 服务提供 show_diff_explanation 工具，用于通过 AI 注释可视化代码更改。

安装

npx -y vibelens-mcp

或全局安装：

npm install -g vibelens-mcp

MCP 配置

将以下内容添加到 MCP 客户端配置中：

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

工具：show_diff_explanation

在 VibeLens 扩展面板中显示带有 AI 生成注释的 git 差异。

参数
参数类型必需描述
titlestring是说明标题
diffstring是原始 git 差异输出（统一格式）
summarystring否更高层次的更改概述
annotationsarray否对差异特定部分的说明
workspacePathstring否项目文件夹的绝对路径（用于工作区筛选）
editorstring否"cursor" 或 "vscode"（默认值："cursor"）
注释对象
字段类型必需描述
filestring是注释所指向的文件路径
linenumber否新文件中的行号
explanationstring是对此更改的说明
actionsarray否带有提示词的操作按钮
操作对象
字段类型必需描述
labelstring是按钮标签（例如，“添加测试”）
promptstring是要发送到聊天的完整提示词
示例
{
  "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"
        }
      ]
    }
  ]
}

提示词：vibelens

MCP 服务还提供了一个用于说明代码更改的提示词。在聊天中使用 @vibelens 引用它。

该提示词引导 AI 执行以下操作：

  1. 从对话上下文获取差异（或在需要时运行 git diff）
  2. 分析并准备注释
  3. 使用适当的参数调用 show_diff_explanation
  4. 为每条注释生成具体且可执行的建议

工作原理

MCP 服务会写入 ~/.vibelens/pending.json，并将审查内容存储在 ~/.vibelens/vibelens.db 中。配套的 VS Code/Cursor 扩展会监视这些数据，并在 Webview 面板中显示差异。

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

开发

# Build
npm run build

# The server runs via stdio
node dist/index.js

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。