vibelens-mcp

VibeLens MCP サーバー

AI による注釈付きでコードの変更を可視化する show_diff_explanation ツールを提供する MCP サーバーです。

インストール

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 diff を表示します。

パラメーター

パラメーター	型	必須	説明
title	string	はい	説明のタイトル
diff	string	はい	生の git diff 出力（統合形式）
summary	string	いいえ	変更の概要
annotations	array	いいえ	diff の特定箇所に対する説明
workspacePath	string	いいえ	プロジェクトフォルダーの絶対パス（ワークスペースのフィルタリング用）
editor	string	いいえ	"cursor" または "vscode"（デフォルト："cursor"）

注釈オブジェクト

フィールド	型	必須	説明
file	string	はい	注釈の対象となるファイルパス
line	number	いいえ	新しいファイルの行番号
explanation	string	はい	この変更についての説明
actions	array	いいえ	プロンプト付きのアクションボタン

アクションオブジェクト

フィールド	型	必須	説明
label	string	はい	ボタンのラベル（例："Add tests"）
prompt	string	はい	チャットに送信する完全なプロンプト

例

{
  "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. 会話のコンテキストから diff を取得する（必要に応じて git diff を実行する）
2. 注釈を分析して準備する
3. 適切なパラメーターを指定して show_diff_explanation を呼び出す
4. 各注釈について、具体的で実行可能な提案を生成する

仕組み

MCP サーバーは ~/.vibelens/pending.json に書き込み、レビューを ~/.vibelens/vibelens.db に保存します。連携する VS Code/Cursor 拡張機能がこのデータを監視し、webview パネルに diff を表示します。

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