✨ Lucidity MCP 🔍
About
AI-powered code quality analysis using MCP to help AI assistants review code more effectively. Analyze git changes for complexity, security issues, and more through structured prompts.
Details
- License
- Apache-2.0
Explore
- 🔮 Comprehensive Issue Detection - Covers 10 critical quality dimensions from complexity to security vulnerabilities
- 🔄 Contextual Analysis - Compares changes against original code to identify unintended modifications
- 🌐 Language Agnostic - Works with any programming language the AI assistant understands
- 🎯 Focused Analysis - Option to target specific issue types based on project needs
- 📝 Structured Outputs - Guides AI to provide actionable feedback with clear recommendations
- 🤖 MCP Integration - Seamless integration with Claude and other MCP-compatible AI assistants
- 🪶 Lightweight Implementation - Simple server design with minimal dependencies
- 🧩 Extensible Framework - Easy to add new issue types or refine analysis criteria
- 🔀 Flexible Transport - Supports both stdio for terminal-based interaction and SSE for network-based communication
- 🔄 Git-Aware Analysis - Analyzes changes directly from git diff, making it ideal for pre-commit reviews
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
✨ Lucidity MCP 🔍Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
uv venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv sync
- Python 3.13 or higher
- Git (for analyzing code changes)
- UV package manager (recommended for dependency management)
analyze_changes
Prepares git changes for analysis through MCP
workspace_root
The root directory of the workspace/git repository
path
Optional specific file path to analyze
- analyze_changes - Prepares git changes for analysis through MCP
- Parameters:
- workspace_root: The root directory of the workspace/git repository
- path: Optional specific file path to analyze
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\u2728 lucidity mcp \ud83d\udd0d": {
"lucidity-mcp": {
"command": "uv",
"args": [
"venv",
".venv"
]
}
}
}
}McpServers
{
"lucidity-mcp": {
"command": "uv",
"args": [
"venv",
".venv"
]
}
}<div align="center">
Clarity in Code, Confidence in Creation
</div>
Lucidity is a Model Context Protocol (MCP) server designed to enhance the quality of AI-generated code through intelligent, prompt-based analysis. By providing structured guidance to AI coding assistants, Lucidity helps identify and address common quality issues, resulting in cleaner, more maintainable, and more robust code.
Before you commit, just ask Lucidity to analyze the changes instead of vibe-coding yourself into a nightmare hellscape! 😱 💥 🚫
💫 Features
- 🔮 Comprehensive Issue Detection - Covers 10 critical quality dimensions from complexity to security vulnerabilities
- 🔄 Contextual Analysis - Compares changes against original code to identify unintended modifications
- 🌐 Language Agnostic - Works with any programming language the AI assistant understands
- 🎯 Focused Analysis - Option to target specific issue types based on project needs
- 📝 Structured Outputs - Guides AI to provide actionable feedback with clear recommendations
- 🤖 MCP Integration - Seamless integration with Claude and other MCP-compatible AI assistants
- 🪶 Lightweight Implementation - Simple server design with minimal dependencies
- 🧩 Extensible Framework - Easy to add new issue types or refine analysis criteria
- 🔀 Flexible Transport - Supports both stdio for terminal-based interaction and SSE for network-based communication
- 🔄 Git-Aware Analysis - Analyzes changes directly from git diff, making it ideal for pre-commit reviews
🚀 Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
