LuciditySAFE
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.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://www.python.org/downloads/) [](LICENSE) [](docs/plan.md) [](https://github.com/astral-sh/ruff) [](https://mypy.readthedocs.io/en/stable/)
Clarity in Code, Confidence in Creation
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 -
7cc25f37b84dOBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add lucidity-mcp -- uvx lucidity-mcp
{
"mcpServers": {
"lucidity-mcp": {
"command": "uvx",
"args": [
"lucidity-mcp"
]
}
}
}Exposed tools (1)
1 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
analyze_changes | read | Prepare git changes for analysis through MCP. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (2)
load_dotenv() # load environment variables from .env
curl -LsSf https://astral.sh/uv/install.sh | sh
Gates applied: no_behavioural_pass.
7cc25f37b84dfull audit observations/trust-audit/mcp-server/hyperb1iss__lucidity.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 7cc25f37b84d | SAFE | B | 89 | first audit |
Questions
What is the Lucidity MCP server?
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.
What tools does Lucidity expose?
1 in total: 1 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Lucidity safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Lucidity need?
No credential environment variables were found in its source, so it appears to need none.
How does Lucidity run?
It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as lucidity-mcp.
How current is this page?
The grade is for one exact copy of the source (7cc25f37b84d), read on 2026-10-07. The repository is watched and re-audited when it changes.