Code Review Analyst MCP

编码镜头MCP服务器

](https://www.npmjs.com/package/%40j0hanz%2Fcode-lens) 

Gemini驱动的MCP服务器，用于自动代码审查、分析和文档编制。

概述

Code Lens是一款 模型上下文协议 使用Google Gemini分析差异、查看拉取请求、检测代码气味、生成文档和验证逻辑的服务器。它通过stdio传输公开了13个工具、7个资源和5个提示。

主要特点

• PR审查管道 -生成差异、评估影响、检测突破性API变更，并生成包含合并建议的评审摘要
• 文件分析 --加载任何源文件，用于重构建议、代码气味检测、文档生成和自然语言问答
• 逻辑验证 --使用Gemini的代码执行沙箱验证算法
• 结构化输出 --所有工具都通过Zod v4输出模式返回经过验证的JSON
• 网络搜索 --基于谷歌搜索的最新信息检索
• 任务生命周期支持 --除以下工具外的所有工具 load_file 可以通过MCP任务运行，包括轮询、取消和进度更新

需求

• Node.js>=24
• A. Gemini API密钥 (GEMINI_API_KEY 或 GOOGLE_API_KEY)

快速开始

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

码头工人

docker run -i --rm -e GEMINI_API_KEY="your-api-key" ghcr.io/j0hanz/code-lens

或者使用Docker Compose：

GEMINI_API_KEY=your-api-key docker compose up

客户端配置

Install in VS Code


添加 .vscode/mcp.json:

{
  "servers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

或通过CLI安装：

code --add-mcp '{"name":"code-lens","command":"npx","args":["-y","@j0hanz/code-lens-mcp@latest"]}'

有关更多信息，请参阅 VS代码MCP文档.

Install in VS Code Insiders


添加 .vscode/mcp.json:

{
  "servers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

或通过CLI安装：

code-insiders --add-mcp '{"name":"code-lens","command":"npx","args":["-y","@j0hanz/code-lens-mcp@latest"]}'

有关更多信息，请参阅 VS代码内部人员MCP文档.

Install in Cursor


添加 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 光标MCP文档.

Install in Visual Studio


添加 mcp.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Visual Studio MCP文档.

Install in Goose


{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 鹅MCP文件.

Install in LM Studio


{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 LM Studio MCP文档.

Install in Claude Desktop

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 克劳德桌面MCP文档.

Install in Claude Code

claude mcp add code-lens -- npx -y @j0hanz/code-lens-mcp@latest

或者添加到配置中：

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 克劳德代码MCP文档.

Install in Windsurf

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Windsurf MCP文件.

Install in Amp

amp mcp add code-lens -- npx -y @j0hanz/code-lens-mcp@latest

或者添加到配置中：

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Amp MCP文档.

Install in Cline

添加 cline_mcp_settings.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 临床MCP文档.

Install in Codex CLI

添加 ~/.codex/config.yaml:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Codex CLI MCP文档.

Install in GitHub Copilot

添加 .vscode/mcp.json:

{
  "servers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 .

Install in Warp

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 扭曲MCP文档.

Install in Kiro

添加 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Kiro MCP文件.

Install in Gemini CLI

添加 ~/.gemini/settings.json:

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Gemini CLI MCP文档.

Install in Zed

添加 ~/.config/zed/settings.json:

{
  "context_servers": {
    "code-lens": {
      "settings": {
        "command": "npx",
        "args": ["-y", "@j0hanz/code-lens-mcp@latest"]
      }
    }
  }
}

有关更多信息，请参阅 Zed MCP文件.

Install in Augment

添加到您的VS代码 settings.json 在...之下 augment.advanced:

{
  "augment.advanced": {
    "mcpServers": [
      {
        "id": "code-lens",
        "command": "npx",
        "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
        "env": {
          "GEMINI_API_KEY": "your-api-key"
        }
      }
    ]
  }
}

有关更多信息，请参阅 补充MCP文件.

Install in Roo Code

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 Roo代码MCP文档.

Install in Kilo Code

{
  "mcpServers": {
    "code-lens": {
      "command": "npx",
      "args": ["-y", "@j0hanz/code-lens-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

有关更多信息，请参阅 基洛代码MCP文档.

用例

PR审查流程

1. 呼叫 generate_diff 捕捉未稳定或阶段性的变化
2. 跑 analyze_pr_impact 评估严重性和突破性变化
3. 跑 generate_review_summary 风险评级和合并建议
4. 跑 detect_api_breaking_changes 检查公众API是否破损
5. 跑 generate_test_plan 生成优先级测试用例

单文件分析

1. 呼叫 load_file 缓存源文件
2. 跑 refactor_code 结构改进建议
3. 跑 detect_code_smells Fowler分类反模式
4. 跑 generate_documentation 生成JSDoc/TSDoc存根
5. 使用 ask_about_code 关于文件的自然语言问答
6. 使用 verify_logic 通过代码执行来验证算法

绩效审计

1. 呼叫 generate_diff 对性能敏感的变化
2. 跑 analyze_time_space_complexity 检测Big-O降解

研究

• 使用 web_search 通过谷歌搜索获取最新文档或API参考资料

建筑

[MCP Client]
    │
    │ Transport: stdio
    ▼
[MCP Server: code-lens]
    │ Entry: src/index.ts → src/server.ts
    │
    ├── initialize / initialized (lifecycle handshake)
    │
    ├── tools/call ──────────────────────────────────────────────
    │   │
    │   │ Diff-based tools (require generate_diff first):
    │   ├── [generate_diff]              Sync — capture git diff
    │   ├── [analyze_pr_impact]          Flash — severity & impact
    │   ├── [generate_review_summary]    Flash — risk & merge rec
    │   ├── [generate_test_plan]         Flash — test cases
    │   ├── [analyze_time_space_complexity] Flash — Big-O analysis
    │   ├── [detect_api_breaking_changes]  Flash — API breakage
    │   │
    │   │ File-based tools (require load_file first):
    │   ├── [load_file]                  Sync — cache source file
    │   ├── [refactor_code]              Flash — refactoring
    │   ├── [detect_code_smells]         Flash — smell detection
    │   ├── [generate_documentation]     Flash — doc stubs
    │   ├── [ask_about_code]             Flash — Q&A
    │   ├── [verify_logic]               Flash — code execution
    │   │
    │   │ Standalone:
    │   └── [web_search]                 Flash — Google Search
    │
    ├── resources/read ──────────────────────────────────────────
    │   ├── [internal://instructions]        Server usage guide
    │   ├── [internal://tool-catalog]        Tool reference
    │   ├── [internal://workflows]           Workflow sequences
    │   ├── [internal://server-config]       Runtime config
    │   ├── [internal://tool-info/{name}]    Per-tool details
    │   ├── [internal://diff/current]        Cached diff (text/x-patch)
    │   └── [internal://file/current]        Cached source file
    │
    ├── prompts/get ─────────────────────────────────────────────
    │   ├── [get-help]           Full server instructions
    │   ├── [review-guide]       Tool + focus area workflow
    │   ├── [select-workflow]    Pipeline by change type
    │   ├── [analyze-file]       File analysis pipeline
    │   └── [tool-chain]         Tool prerequisite chain
    │
    └── Capabilities: structured output, tool annotations, notifications

请求的生命周期

[Client] -- initialize {protocolVersion, capabilities} --> [Server]
[Server] -- {protocolVersion, capabilities, serverInfo} --> [Client]
[Client] -- notifications/initialized --> [Server]
[Client] -- tools/call {name, arguments} --> [Server]
[Server] -- notifications/progress {token, progress, total} --> [Client]
[Server] -- {content, structuredContent, isError?} --> [Client]

任务生命周期

• generate_diff 和 load_file 仅同步。所有其他工具都做广告 taskSupport: optional.
• 请求者可以提供任务TTL。服务器最多使用该值 MAX_TASK_TTL_MS，或回落到 TASK_TTL_MS 当省略时。
• 已取消的任务仍处于终止状态 cancelled，以及 tasks/result 返回一个取消形状的工具结果。

MCP表面

工具

资源

提示

MCP能力

工具注释

所有工具都公开MCP工具注释：

结构化输出

所有Gemini电动工具返回验证 structuredContent 旁边文字 content，使用Zod v4输出模式。

配置

CLI标志

npx @j0hanz/code-lens-mcp@latest --model gemini-2.5-flash --max-diff-chars 200000

安全

发展

npm install          # Install dependencies
npm run build        # Compile TypeScript
npm run dev          # Watch mode
npm run dev:run      # Run with --watch and .env
npm run start        # Run compiled server
npm run type-check   # Type-check src + tests
npm run lint         # ESLint
npm run test         # Run test suite
npm run format       # Prettier
npm run inspector    # MCP Inspector
npm run knip         # Dead code detection

构建与发布

• CI： .github/workflows/release.yml
• Docker：多阶段构建(Dockerfile)与 node:24-alpine
• Docker编写： docker-compose.yml
• npm：发布为 @j0hanz/code-lens-mcp

故障排除

• 缺少API密钥：设置 GEMINI_API_KEY 或 GOOGLE_API_KEY 在您的环境或客户端配置中 env 块。
• “E_NO_DIFF”错误：呼叫 generate_diff 在运行任何基于差异的审查工具之前。
• “E_NO_FILE”错误：呼叫 load_file 在运行任何文件分析工具之前。
• 大差异被截断：增加 MAX_DIFF_CHARS （默认值：120000个字符）。
• 标准噪声：确保没有其他进程写入stdout；服务器使用stdio传输。

积分

• 谷歌双子座 --LLM后端(@google/genai)
• 模型上下文协议SDK --MCP框架(@modelcontextprotocol/sdk)
• 黄道带 --架构验证(zod v4）
• 解析差异 --Diff解析

贡献和许可

MIT许可证。看 许可证 了解详情。

欢迎通过以下方式捐款 拉取请求.