使用说明

项目简介

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 集成配置指南,方便用户快速上手。

安装步骤

  1. 安装 Node.js 20+: 确保您的系统已安装 Node.js 20 或更高版本。您可以从 Node.js官网 下载并安装。

  2. 安装 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' 字段进行配置。

基本使用方法

  1. 启动 MCP 服务器: 当您在 VS Code Insiders 或 Claude Desktop 中配置并启用 Grumpy Senior Dev MCP Server 后,服务器会在后台自动启动。
  2. 调用代码审查工具: 在您的 AI 编码助手客户端中,当需要进行代码审查时,可以使用 'review_code' 工具,并将需要审查的代码作为参数传递给工具。服务器将返回“Grumpy Senior Dev”风格的代码审查结果。
  3. 配置模型 (可选): 如果您想使用特定的 AI 模型进行代码审查,可以设置环境变量 'GENAISCRIPT_DEFAULT_MODEL'。例如,设置为 'github:gpt-4o' 使用 GitHub Models 的 GPT-4o 模型。

注意: 请确保您的 MCP 客户端(VS Code Insiders 或 Claude Desktop)已正确配置并支持 MCP 协议,并且已启用 Grumpy Senior Dev MCP Server。

信息

分类

开发者工具