使用说明
项目简介
Grumpy Senior Dev MCP Server 是一款基于 Model Context Protocol (MCP) 构建的服务器应用,旨在模拟一位经验丰富但脾气暴躁的老年开发者,对代码进行尖锐而幽默的审查。它通过 MCP 协议与 AI 编码助手(如 GitHub Copilot、Claude)集成,作为一个代码审查工具,为开发者提供别具一格的代码质量反馈。
主要功能点
- 代码审查工具: 提供 'review_code' 工具,接受代码片段作为输入,返回以“尖酸刻薄”风格编写的代码审查意见。
- MCP 服务器: 遵循 MCP 协议,能够与支持 MCP 协议的客户端(如 VS Code Insiders, Claude Desktop)进行通信,提供工具注册和执行服务。
- 可配置模型: 支持通过环境变量 'GENAISCRIPT_DEFAULT_MODEL' 配置底层使用的 AI 模型,默认使用 GitHub Models 的 GPT-4o 模型。
- 易于集成: 提供详细的 VS Code Insiders 和 Claude Desktop 集成配置指南,方便用户快速上手。
安装步骤
-
安装 Node.js 20+: 确保您的系统已安装 Node.js 20 或更高版本。您可以从 Node.js官网 下载并安装。
-
安装 MCP 服务器: 您可以通过以下任一方式安装 Grumpy Senior Dev MCP Server:
-
通过 VS Code Insiders 扩展安装 (推荐): 点击 Install in VS Code Insiders 链接,在 VS Code Insiders 中安装。
-
通过命令行安装: 打开终端,执行命令 'code-insiders --add-mcp '{"name":"grumpydev","command":"npx","args":["-y","grumpydev-mcp"]}''。
-
手动配置 '.vscode/mcp.json': 在您的项目工作区根目录下创建或编辑 '.vscode/mcp.json' 文件,添加以下配置:
{ "servers": { "grumpydev-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "grumpydev-mcp" ] } } }
-
服务器配置
MCP 客户端需要配置服务器的连接信息才能使用 Grumpy Senior Dev MCP Server。以下是针对不同 MCP 客户端的配置示例:
-
VS Code Insiders 配置 (在 '.vscode/mcp.json' 中):
{ "servers": { "grumpydev-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "grumpydev-mcp" ] } } }配置说明:
- 'server name': 'grumpydev-mcp' (服务器名称,客户端用于标识)
- 'command': 'npx' (启动服务器的命令,这里使用 npx 执行 npm 包)
- 'args': '["-y", "grumpydev-mcp"]' (传递给 'npx' 命令的参数,'-y' 表示自动确认安装,'grumpydev-mcp' 是要执行的 npm 包名)
- 'type': 'stdio' (指定使用标准输入输出流进行通信)
-
Claude Desktop 配置 (在 'claude_desktop_config.json' 中):
{ "mcpServers": { "grumpydev-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "grumpydev-mcp" ] } } }配置说明:
- 配置项与 VS Code Insiders 类似, Claude Desktop 通过 'claude_desktop_config.json' 文件中的 'mcpServers' 字段进行配置。
基本使用方法
- 启动 MCP 服务器: 当您在 VS Code Insiders 或 Claude Desktop 中配置并启用 Grumpy Senior Dev MCP Server 后,服务器会在后台自动启动。
- 调用代码审查工具: 在您的 AI 编码助手客户端中,当需要进行代码审查时,可以使用 'review_code' 工具,并将需要审查的代码作为参数传递给工具。服务器将返回“Grumpy Senior Dev”风格的代码审查结果。
- 配置模型 (可选): 如果您想使用特定的 AI 模型进行代码审查,可以设置环境变量 'GENAISCRIPT_DEFAULT_MODEL'。例如,设置为 'github:gpt-4o' 使用 GitHub Models 的 GPT-4o 模型。
注意: 请确保您的 MCP 客户端(VS Code Insiders 或 Claude Desktop)已正确配置并支持 MCP 协议,并且已启用 Grumpy Senior Dev MCP Server。
信息
分类
开发者工具