Jithendra123892/smart-code-reviewer
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.
🚀 Smart Code Review Assistant
An AI-powered MCP server that provides intelligent code reviews, security scanning, and documentation generation for development teams.
✨ 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
- High Daily Usage: Every developer needs code reviews - this solves a real problem
- Viral Potential: Teams will share this with other developers immediately
- Enterprise Ready: Security scanning makes this valuable for companies
- 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:
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- 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! ⭐