MAGI Code Review

🚀 MAGI Code Review System

MAGI is an intelligent code review platform that streamlines the code review process and ensures high - quality code.

🚀 Quick Start

The MAGI system is an intelligent code review platform, which mainly consists of the following parts:

✨ Features

1. Client

• Function: It is responsible for submitting code files to be reviewed and receiving review results.
• Workflow:
  1. Submit the code to be reviewed to the MCP server.
  2. Receive and display the review result report.

2. Server

• Role: It serves as a bridge between the client and the MAGI gateway.
• Architecture:

  Test Client <-> MCP Server <-> MAGI Gateway <-> Review Agents (Melchior, Balthasar, Casper)
  

3. Review Agents

Melchior

• Responsibility: It is responsible for the architectural review of the code.
• Review Content:
  • Code structure analysis.
  • Design pattern evaluation.
  • System coupling check.
  • Scalability analysis.

Balthasar

• Responsibility: It is responsible for security and stability review.
• Review Content:
  • Input validation check.
  • Error handling mechanism.
  • Security vulnerability scanning.
  • System stability and fault - tolerance evaluation.

Casper

• Responsibility: It is responsible for the review of functional integrity and user experience.
• Review Content:
  • Completeness of function implementation.
  • User interaction experience.
  • Documentation.
  • Error prompts and log records.

Review Process

1. The client submits the code to the MCP server.
2. The server forwards the code to the MAGI gateway.
3. The gateway distributes the code to the three review agents for parallel evaluation.
4. Each agent generates a POSITIVE or NEGATIVE decision result.
5. The final decision adopts the majority - voting mechanism (at least two positive evaluations are required to pass).
6. The review result is sent back to the client.

📚 Documentation

Development Information

Debug Mode

• Enable debug logs:

  DEBUG=1 python -m src.server
  

• Use debug options on the client:

  python -m src.client --file my_code.py --debug
  

📄 License

This project is licensed under the MIT license.