🚀 MCP 服务器 - 代码审查

MCP 服务器用于实现 Model Context Protocol (MCP)，借助 stdio 将 Cursor 连接到 OpenRouter API，为用户提供代码审查和 AI 聊天功能。

🚀 快速开始

MCP 服务器能让您轻松连接 OpenRouter API，实现代码审查和 AI 聊天等功能。您可以按照以下步骤进行操作。

✨ 主要特性

• 连接 OpenRouter API，可访问多种大型语言模型。
• 提供两大核心功能：
  • 简单文本提示响应（ask 工具）。
  • 带项目上下文分析的自动化代码审查（code_review 工具）。
• 集成 repomix 进行代码库打包和分析。
• 支持多种编程语言项目的自动检测。
• 作为符合 MCP 协议的 stdio 服务器运行。

📦 安装指南

# 全局安装
npm install -g mcp-server-code-review

# 或者在项目中本地安装
npm install mcp-server-code-review

📚 详细文档

配置要求

• Node.js v16 或更高版本。
• OpenRouter API 密钥 - 获取方式：OpenRouter

使用方法

命令行选项

mcp-server-code-review --api-key YOUR_OPENROUTER_API_KEY [--default-model MODEL_ID]

参数说明

• --api-key, -k（必填）：您的 OpenRouter API 密钥。
• --default-model, -m（可选）：默认使用的模型 ID（默认为 google/gemini-2.0-flash-thinking-exp:free）。

示例用法

mcp-server-code-review --api-key sk-or-v1-xxxxxxxxxxxx --default-model anthropic/claude-3-haiku:free

MCP 工具说明

该服务器实现两大主要 MCP 工具：

1. Ask 工具

将简单文本提示发送到 OpenRouter API 并返回响应。

"mcp-openrouter-stdio": {
      "name": "mcp-openrouter-stdio",
      "command": "npx",
      "args": [
        "mcp-openrouter-stdio",
        "--api-key",
        "sk-or-v1-your_key",
        "--default-model",
        "google/gemini-2.0-flash-thinking-exp:free"
      ],
      "transport": "stdio"
    },

2. Code Review 工具

使用 OpenRouter API 进行代码审查，带项目上下文分析。

{
  name: "code_review",
  arguments: {
    completed_tasks: ["任务 1", "任务 2"],
    work_report: "执行工作细节",
    project_path: "/absolute/path/to/project",
    planned_tasks: ["未来任务 1", "未来任务 2"],
    language: "js", // 项目的主编程语言
    model: "optional-model-id" // 若未指定则使用默认模型
  }
}

支持的语言

该服务器支持自动检测和分析多种编程语言的项目：

• JavaScript/TypeScript（js）
• Python（python）
• C#（csharp）
• PHP（php）
• Java（java）
• Ruby（ruby）
• Go（go）
• Rust（rust）
• C++（cpp）
• Swift（swift）

开发步骤

# 克隆仓库
git clone https://github.com/arahisman/mcp-server-code-review.git
cd mcp-server-code-review

# 安装依赖项
npm install

# 构建项目
npm run build

# 启用开发模式
npm run watch

测试脚本

仓库包含多个测试脚本：

# 基本服务器测试
node test-mcp-server.js

# 测试 ask 工具
node test-ask.js

# 简单功能测试
node simple-test.js

📄 许可证

MIT

作者

Adam Rahisman