smart-code-reviewer

Jithendra123892/smart-code-reviewer

3.3

If you are the rightful owner of smart-code-reviewer and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

An AI-powered MCP server that provides intelligent code reviews, security scanning, and documentation generation for development teams.

Tools
5
Resources
0
Prompts
0

🚀 Smart Code Review Assistant

An AI-powered MCP server that provides intelligent code reviews, security scanning, and documentation generation for development teams.

Team Neurons Puch AI Hackathon

✨ Features

🔍 Intelligent Code Analysis

  • Security Vulnerability Detection: Identifies SQL injection, XSS, hardcoded secrets, and more
  • Bug Detection: Catches common programming errors and logic issues
  • Performance Analysis: Suggests optimizations and identifies bottlenecks
  • Code Style & Best Practices: Enforces consistent coding standards

📝 Smart Documentation

  • Auto-Generated Docs: Creates markdown documentation from code
  • Function & Class Analysis: Extracts and documents all functions and classes
  • Usage Examples: Provides code usage patterns and examples

🔄 Git Integration

  • Commit Review: Analyze specific commits for quality issues
  • Staged Changes Review: Review code before committing
  • Diff Analysis: Smart analysis of code changes

🛡️ Security First

  • OWASP Top 10 Coverage: Detects major security vulnerabilities
  • Secret Detection: Finds hardcoded API keys, passwords, tokens
  • Security Recommendations: Actionable advice to fix vulnerabilities

🎯 Why This Will Win the Hackathon

  1. High Daily Usage: Every developer needs code reviews - this solves a real problem
  2. Viral Potential: Teams will share this with other developers immediately
  3. Enterprise Ready: Security scanning makes this valuable for companies
  4. Developer Experience: Seamlessly integrates into existing workflows

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • Git
  • Puch AI account

Installation

# Clone the repository
git clone https://github.com/neurons/smart-code-reviewer.git
cd smart-code-reviewer

# Install dependencies
npm install

# Build the project
npm run build

# Start the MCP server
npm start

🛠️ Available Tools

1. review_code_file

Analyzes a code file for bugs, security issues, performance problems, and style violations.

{
  "filePath": "path/to/your/file.js",
  "content": "optional direct code content"
}

2. review_git_changes

Reviews staged git changes or a specific commit.

{
  "commitHash": "abc123..." 
}

3. generate_documentation

Creates comprehensive markdown documentation for code files.

{
  "filePath": "path/to/your/file.js",
  "content": "optional direct code content"
}

4. security_scan

Performs deep security analysis of code files.

{
  "path": "path/to/file/or/directory"
}

5. explain_code

Provides detailed explanations of complex code segments.

{
  "code": "your code snippet here",
  "language": "javascript" // optional
}

📊 Sample Output

Code Review Results

# Code Review Results for example.js

## Summary
- **Total Issues**: 12
- **Errors**: 2
- **Warnings**: 7  
- **Info**: 3

## Issues by Category
- **Security**: 3 🔴
- **Bugs**: 2 🟠
- **Performance**: 4 🟡
- **Style**: 3 🟢

### Issue 1 (Line 15)
**Severity**: ERROR
**Category**: security
**Message**: Security: Potential SQL injection vulnerability detected
**Suggestion**: Use parameterized queries or prepared statements

Security Scan Results

# Security Scan Results for app.js

## Vulnerability Summary
- **Critical**: 1 🔴
- **High**: 2 🟠
- **Medium**: 3 🟡
- **Low**: 1 🟢

### Vulnerability 1 (Line 42)
**Severity**: CRITICAL
**Type**: Hardcoded Secret
**Description**: Hardcoded credentials detected in source code
**Recommendation**: Move credentials to environment variables

🔧 Development

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

# Lint code
npx eslint src/

# Build for production
npm run build

📈 Usage Analytics

This MCP server tracks usage statistics to show on the hackathon leaderboard:

  • Code files analyzed: Real-time counter
  • Security vulnerabilities found: Impact metrics
  • Documentation generated: Productivity metrics
  • Teams using the tool: Viral growth tracking

🤝 Contributing

We welcome contributions! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests
  5. Submit a pull request

🏆 Team Neurons

Built with ❤️ for the Puch AI Hackathon by Team Neurons

  • Focus: Developer productivity and security
  • Mission: Make code reviews intelligent and accessible
  • Vision: Every developer deserves AI-powered code assistance

🎖️ Hackathon Strategy

Phase 1: Build

  • ✅ Core MCP server implementation
  • ✅ 5 essential tools for code review
  • ✅ Security vulnerability detection
  • ✅ Git integration
  • ✅ Documentation generation

Phase 2: Scale 🚀

  • 📢 Share with development communities
  • 🎥 Create demo videos showing real value
  • 📝 Write tutorials and blog posts
  • 🤝 Partner with developer teams for feedback
  • 📊 Track usage metrics for leaderboard

📜 License

MIT License - see for details.

🔗 Links


⭐ Star this repository if you find it useful! It helps us climb the leaderboard! ⭐