# LucidShark

LucidShark — an MCP server for Claude Code and other IDEs. Automates code quality checks, security, and testing within your project.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20 repo stars
- Author: toniantunovi
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/toniantunovi/lucidshark
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/lucidshark

## What it does

LucidShark scans code for linting violations, type errors, security threats (SAST/SCA), and test coverage. It runs locally without needing a SaaS account.

Configuration is defined in `lucidshark.yml`, ensuring consistent rules across the team. It provides feedback in a structured format that AI agents can process for automated fixes.

The tool verifies checksums for all downloaded binaries to ensure integrity. Before running, it checks for installed requirements or downloads necessary scanners automatically.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add lucidshark -- uvx lucidshark
```
uvx runs the command named after the package; if the README names another one, use uvx --from lucidshark <command>

### Codex

**Platform CLI**
```bash
codex mcp add lucidshark -- uvx lucidshark
```
uvx runs the command named after the package; if the README names another one, use uvx --from lucidshark <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lucidshark": {
            "command": "uvx",
            "args": [
                "lucidshark"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from lucidshark <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lucidshark": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "lucidshark"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from lucidshark <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add lucidshark uvx lucidshark
```
uvx runs the command named after the package; if the README names another one, use uvx --from lucidshark <command>

## When to use it
- Identify SAST and SCA security vulnerabilities
- Detect code formatting and type checking issues
- Execute project tests and report coverage
- Apply automated linting fixes

## Example prompts
- Run all security scans on the current project
- Analyze code quality and suggest fixes for linting errors
- Configure LucidShark settings for this repository

## Similar
- [find-security-vulnerabilities-in-code](https://affpapa.org/en/nevibecode/skills/find-security-vulnerabilities-in-code.md) — skill · 17400 installs
- [sast-hunter](https://affpapa.org/en/nevibecode/agents/sast-hunter.md) — subagent · ★ 1298 repo stars
- [triage](https://affpapa.org/en/nevibecode/skills/anthropics-triage.md) — skill · 1200 installs
- [agentic-security-scanner](https://affpapa.org/en/nevibecode/skills/agentic-security-scanner.md) — skill · 467 installs
- [Code Pathfinder](https://affpapa.org/en/nevibecode/mcp/code-pathfinder.md) — MCP server · ★ 143 repo stars
- [golang-security](https://affpapa.org/en/nevibecode/skills/golang-security.md) — skill · 45100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
