Tổng quan Hệ thống

Mục tiêu của phần này là cung cấp cái nhìn toàn cảnh về MCP Code Review Server. Đây là một máy chủ Model Context Protocol chuyên dụng, hoạt động như một cầu nối an toàn và thông minh giữa các AI IDEs (như Cursor, Claude Desktop) và mã nguồn cục bộ của bạn. Phần này minh họa cách hệ thống tối ưu hóa tài nguyên phân tích và đảm bảo bảo mật.

Tối ưu hóa Token (RTK - Rust Token Killer)

Đánh chặn âm thầm và nén dữ liệu đầu ra từ các câu lệnh shell từ 60% đến 90% trước khi gửi vào Context Window của AI, tránh làm loãng ngữ cảnh và giảm chi phí API đáng kể.

Tiết kiệm ~70% Token

Core Ngữ cảnh (30%)

Boilerplate đã nén (70%)

🧹 Smart Filtering Lọc khoảng trắng, comments, boilerplate mặc định và thanh tiến trình.

📦 Grouping Tự động gom nhóm tệp rời rạc hoặc cảnh báo linter theo thư mục/quy tắc.

✂️ Truncation Chỉ giữ lại ngữ cảnh giá trị nhất (như log lỗi) và cắt bớt phần thành công thừa.

🔄 Deduplication Gộp hàng trăm log lỗi giống nhau lặp lại thành một dòng kèm chỉ số đếm.

* Số liệu dựa trên báo cáo benchmarks thực tế từ proxy rtk-ai.app.

🔎

Smart Diff Analysis

Thay vì gửi toàn bộ tệp tin cồng kềnh cho AI, server chỉ trích xuất các "hunks" (đoạn thay đổi) và định dạng chúng kèm theo số dòng chính xác. Điều này giúp AI tham chiếu lỗi nhanh và rẻ hơn.

Hỗ trợ Git & Local Optimized Payload

🔒

Bảo mật ưu tiên (Security-first)

Hệ thống sử dụng cơ chế Whitelist khắt khe. AI chỉ có thể đọc các tệp tin trong danh mục thư mục được cấp phép (mặc định là process.cwd()), ngăn chặn hoàn toàn các nỗ lực truy cập hệ thống trái phép (Directory Traversal).

Directory Whitelist Sandbox Protected

Giao thức Hoạt động MCP (MCP Lifecycle Simulator)

Khám phá cách thức trao đổi giao thức tiêu chuẩn (Model Context Protocol Specification) giữa AI Client và Local MCP Server. Chọn các hành động cốt lõi bên dưới để xem luồng truyền thông điệp JSON-RPC 2.0 thời gian thực.

Chọn hành động để giả lập:

AI Client

Cursor / Claude

JSON-RPC 2.0

MCP Server

mcp-reviewer

Protocol JSON-RPC Inspector

--> Client Request Payload

Đang nạp cấu trúc...

<-- Server Response Payload

Đang nạp cấu trúc...

Đang kết nối...

Đang tải...

Báo cáo kiểm toán Markdown mẫu được tạo lập tự động

Khi MCP thực thi các công cụ rà soát (như reviewFile), nó sẽ tự động kết xuất ra một tệp báo cáo chi tiết dưới định dạng Markdown (.md) lưu trữ trực tiếp tại máy cục bộ.

---
inclusion: manual
description: Code review mode context for thorough quality and security assessment
---

Review Mode Report

File Content (Keyword Filter Engine)

"""
Keyword-based similarity utilities for hybrid duplicate detection.
"""
import re
from typing import List, Dict
from dataclasses import dataclass
from collections import Counter
import logging

# Check Japanese Tokenization availability
try:
    from janome.tokenizer import Tokenizer
    JANOME_AVAILABLE = True
except ImportError:
    JANOME_AVAILABLE = False
    logging.warning("Janome library not found. Falling back to simple regex.")

Phase 1: Initial Assessment Checklist

Display Changed Files: Liệt kê và khoanh vùng các tệp Git diff.
Context comprehension: Hiểu rõ mục đích logic nghiệp vụ của nhánh/PR.

Standards Compliance Requirements

Category	Convention	Example
Classes	PascalCase	class UserProfile:
Functions	snake_case	def calculate_total():

MCP Review

Tổng quan Hệ thống

Tối ưu hóa Token (RTK - Rust Token Killer)

Smart Diff Analysis

Bảo mật ưu tiên (Security-first)

Danh mục Công cụ (Tools)

codeReview

reviewFile

getLocalGitDiff

fetchContext7

Quy trình Review 4 Giai đoạn

Giai đoạn 1: Assessment (Đánh giá)

🚀 Hành động đề xuất cho AI:

Tích hợp & Cấu hình

Cấu hình Cơ bản (.env)

Giới hạn Token & Nén

Bảo mật Thư mục

Giao thức Hoạt động MCP (MCP Lifecycle Simulator)

Đang kết nối...

Xây dựng ứng dụng có thể chạy được MCP

Báo cáo kiểm toán Markdown mẫu được tạo lập tự động

Review Mode Report

File Content (Keyword Filter Engine)

Phase 1: Initial Assessment Checklist

Standards Compliance Requirements

Phân tích báo cáo tự động từ tệp tin bởi Gemini 2.5 Flash

Phân tích báo cáo tự động từ tệp tin bởi OpenAI ChatGPT

Tích hợp MCP Agent tự động vào VS Code / Cursor