MuXiReview MCP

队伍：原启

项目名称：MuXiReview MCP：基于沐曦算力的代码审查 Skill / MCP 服务

项目简介：MuXiReview MCP 面向开发者代码审查场景，基于沐曦算力环境中的 OpenAI 兼容大模型服务，对 git diff / patch 进行结构化审查，输出缺陷风险、回归隐患和测试建议。项目提供 CLI、HTTP API、MCP 三种使用方式，方便直接集成到 Codex、Claude Code、OpenClaw 等工具链。

核心价值

面向开发者真实工作流，在提交代码前快速做一次 AI 审查
聚焦 bug、回归风险、边界条件遗漏、缺失测试
输出结构化 JSON 报告，方便展示、归档和二次处理
依托沐曦算力环境完成真实模型调用和比赛演示

核心功能

review：审查 patch 文件或本地 git diff
review_patch / review_repo_diff：作为 MCP 工具调用
logs/muxibench.jsonl：记录真实审查调用日志
reports/review-sample.json：结构化样例报告
reports/review-sample.md：便于展示的 Markdown 报告

保留辅助能力：

health-check
chat
benchmark
compare

接入环境

接口类型：OpenAI Chat Completions 兼容
API Base URL：https://api.moark.com/v1
默认模型：DeepSeek-V4-Flash

环境变量示例：

export MUXI_API_BASE_URL="https://api.moark.com/v1"
export MUXI_API_KEY="your-real-api-key"
export MUXI_MODEL="DeepSeek-V4-Flash"
export MUXI_REQUEST_TIMEOUT="60"

CLI 使用

审查 patch 文件：

python -m muxibench review --diff-file patch.diff --output reports/review.json

审查本地仓库未提交改动：

python -m muxibench review --repo-path /path/to/repo

审查暂存区改动：

python -m muxibench review --repo-path /path/to/repo --staged

辅助命令：

python -m muxibench health-check
python -m muxibench benchmark --prompt "请解释首 token 延迟和吞吐量的区别" --runs 3 --concurrency 1

HTTP API

GET /health
POST /review
POST /review-repo-diff
POST /chat
POST /benchmark
POST /compare
POST /export-report

MCP 工具

review_patch
review_repo_diff
health_check
chat
benchmark
compare
export_report

review_patch 输入示例：

{
  "patch": "diff --git a/app.py b/app.py\n...",
  "repo_context": "Repository path: /workspace/demo",
  "output_path": "reports/review.json"
}

输出格式

审查结果默认输出 JSON，核心字段如下：

{
  "summary": "检测到一个高风险回归问题。",
  "risk_level": "high",
  "findings": [
    {
      "title": "空返回值未处理",
      "severity": "high",
      "file": "service.py",
      "evidence": "新增逻辑直接访问 result['data']。",
      "recommendation": "增加空值判断并补回归测试。"
    }
  ],
  "test_suggestions": [
    "补充 result 为空时的单元测试"
  ],
  "model": "deepseek-v4-flash",
  "latency_seconds": 4.2
}

示例材料

JSON 样例：reports/review-sample.json
Markdown 样例：reports/review-sample.md
真实 benchmark 报告：reports/benchmark.md
真实调用日志：logs/muxibench.jsonl

比赛演示顺序建议

展示环境变量和模型接入配置
展示一段待审查 git diff
执行 review 命令
展示结构化 JSON 报告
展示日志文件和样例 Markdown 报告
补充一次 health-check 或 benchmark 证明真实调用链路