# Clone the repository
git clone https://github.com/geethikakoya/mcp-code-agent.git
cd mcp-code-agent

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e .

# Get your API key from https://console.anthropic.com/
export ANTHROPIC_API_KEY=your_api_key_here

# Review a file
mcp-review review src/main.py

# Review with streaming output
mcp-review review --stream src/main.py

# Review git changes
mcp-review diff

# Explain what a file does
mcp-review explain src/utils.py

# Quick analysis (no AI, just metrics)
mcp-review analyze src/main.py

┌─────────────────────────────────────────────────────────────┐
│                    Code Review Agent                        │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌──────────┐      ┌──────────────┐      ┌──────────────┐  │
│  │  CLI     │─────▶│  Agent       │─────▶│  Claude API  │  │
│  │  (typer) │◀─────│  (reviewer)  │◀─────│  (LLM)       │  │
│  └──────────┘      └──────────────┘      └──────────────┘  │
│                           │                                 │
│                           ▼                                 │
│                    ┌──────────────┐                        │
│                    │  MCP Tools   │                        │
│                    └──────────────┘                        │
│                           │                                 │
│              ┌────────────┼────────────┐                   │
│              ▼            ▼            ▼                   │
│        ┌─────────┐  ┌─────────┐  ┌─────────┐              │
│        │  File   │  │   Git   │  │  Code   │              │
│        │  Tools  │  │  Tools  │  │ Analysis│              │
│        └─────────┘  └─────────┘  └─────────┘              │
│                                                             │
└─────────────────────────────────────────────────────────────┘

🔍 Reviewing: src/api/handler.py

📊 Metrics Summary
• Lines of Code: 142
• Cyclomatic Complexity: 8 (Moderate)
• Maintainability Index: 65.2

🔴 Critical Issues
1. Line 45: SQL injection vulnerability - use parameterized queries

⚠️ Warnings
1. Line 23: Function too long (>50 lines) - consider splitting
2. Line 67: Magic number - extract to constant

💡 Suggestions
1. Add type hints to function parameters
2. Consider using dataclass for UserData

✅ What's Good
• Good error handling in API endpoints
• Consistent naming conventions

mcp-code-agent/
├── src/
│   ├── mcp_server/           # MCP Server (exposes tools)
│   │   ├── server.py         # Main MCP server
│   │   └── tools/
│   │       ├── file_tools.py
│   │       ├── git_tools.py
│   │       └── analysis_tools.py
│   │
│   ├── agent/                # AI Agent
│   │   ├── reviewer.py       # Code review logic
│   │   └── prompts.py        # System prompts
│   │
│   └── cli/                  # CLI interface
│       └── main.py
│
├── tests/
├── pyproject.toml
├── requirements.txt
└── README.md

# Run the MCP server
mcp-review server

{
  "mcpServers": {
    "code-review": {
      "command": "python",
      "args": ["-m", "src.mcp_server.server"],
      "cwd": "/path/to/mcp-code-agent"
    }
  }
}

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Format code
black src/
ruff check src/