1. Conduid
  2. Developer Tools
  3. phuongrealmax/code-guardian
MCP server · Developer Tools

phuongrealmax/code-guardian

by · github.com/phuongrealmax/code-guardian

Code Guardian Studio – AI-powered code refactor engine for large repositories, built on Claude Code + MCP.

Unclaimed last commit 10 months ago devtools
InstallView source
56Fair

Scored 6 days ago · breakdown

About phuongrealmax/code-guardian

phuongrealmax/code-guardian is an MCP server published by phuongrealmax in the Developer Tools category: code Guardian Studio – AI-powered code refactor engine for large repositories, built on Claude Code + MCP.

The repository has 9 stars and 3 forks, with the last commit 10 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

uvx
uvx code-guardian-mcp
pip
pip install code-guardian-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about phuongrealmax/code-guardian

Powered by Claude · Grounded in docs

I know everything about phuongrealmax/code-guardian. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v4.0.1v4.0.1
v4.0.0v4.0.0

README

Code Guardian Studio

npm version npm downloads license node MCP Tools MCP Server GitHub stars GitHub Discussions

AI-powered code refactor engine for large repositories, built on Claude Code + MCP.

Version: 4.1.0 | License: MIT (open-core)

Website & Docs: https://codeguardian.studio

Why CCG?

CCG stands out as the most comprehensive MCP server for Claude Code:

CCG Guardrails AI NeMo Semgrep MCP
MCP Tools 113+ - - ~10
Code Analysis ✅ ❌ ❌ ✅
Hotspot Detection ✅ ❌ ❌ ❌
Workflow Management ✅ ❌ ❌ ❌
Session Persistence ✅ ❌ ❌ ❌
Memory System ✅ ❌ ❌ ❌
Progress Dashboard ✅ ❌ ❌ ❌
Latent Chain Reasoning ✅ ❌ ❌ ❌
Guard Rules ✅ ✅ ✅ ✅

Key Differentiators:

  • All-in-one: Guard + Metrics + Workflow + Memory in a single server
  • 113+ MCP tools: The most comprehensive toolset available
  • Session management: Resume work across conversations
  • Real-time progress: Track refactoring progress with live dashboard
  • Latent Chain: Multi-phase reasoning for complex tasks

Want detailed comparisons? See CCG vs Competitors

What is Code Guardian Studio?

Code Guardian Studio (CCG) is an MCP server that transforms Claude Code into an intelligent refactoring assistant. It scans your codebase, finds hotspots, generates optimization reports, and helps you refactor safely.

Key Stats (from dogfooding CCG on itself)

Metric Value
Lines Analyzed 68,000
Files Scanned 212
Hotspots Found 20
Analysis Time < 1 minute

3-Minute Quickstart

Get your first code analysis in one command:

# Install globally
npm install -g codeguardian-studio

# Run quickstart (auto-initializes + analyzes your code)
ccg quickstart

That's it! The quickstart command will:

  • Initialize CCG in your project
  • Scan your codebase
  • Analyze code complexity and hotspots
  • Generate a detailed markdown report

Open the generated report and start fixing hotspots (highest score first).

Want more control? See Manual Setup or read the full Quickstart Guide.

Features

Code Optimizer (8 tools)

  • code_scan_repository - Map your entire codebase
  • code_metrics - Calculate complexity, nesting, branch scores
  • code_hotspots - Find files that need attention
  • code_refactor_plan - Generate step-by-step refactor plans
  • code_record_optimization - Log optimization sessions
  • code_generate_report - Create Markdown reports
  • code_quick_analysis - Scan + metrics + hotspots in one call
  • code_optimizer_status - Check module status

Additional Modules

  • Memory - Persistent storage across sessions
  • Guard - Block dangerous patterns (fake tests, empty catches, etc.)
  • Workflow - Task management and tracking
  • Latent Chain - Multi-phase reasoning for complex tasks
  • Agents - Specialized agent coordination
  • Thinking - Structured reasoning models
  • Documents - Documentation management
  • Testing - Test runner integration

Pricing

Plan Price Best For
Dev Free Solo devs, fully offline
Team $19/mo Product teams & agencies
Enterprise Custom Large orgs & compliance

Dev tier is 100% local and self-hostable. Team/Enterprise require license validation via api.codeguardian.studio.

See License Tiers for feature comparison.

Links

Manual Setup

If you prefer step-by-step control:

# 1. Install
npm install -g codeguardian-studio

# 2. Initialize CCG in your project
ccg init

# 3. Run analysis with custom options
ccg code-optimize --report

# 4. For advanced options
ccg code-optimize --help-advanced

See the User Guide for more details.

Installation Requirements

CCG uses better-sqlite3 (native SQLite bindings) which requires build tools on your system:

Linux (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install build-essential python3
npm install -g codeguardian-studio

macOS

# Install Xcode Command Line Tools
xcode-select --install

npm install -g codeguardian-studio

Windows

# Install Visual Studio Build Tools
# Download from: https://visualstudio.microsoft.com/downloads/

npm install -g codeguardian-studio

Docker

FROM node:20-slim

# Install build dependencies
RUN apt-get update && apt-get install -y \
    build-essential \
    python3 \
    && rm -rf /var/lib/apt/lists/*

RUN npm install -g codeguardian-studio

Troubleshooting

Error: gyp ERR! stack Error: not found: make

  • Solution: Install build tools (see above for your OS)

Error: Module did not self-register

  • Solution: Node.js version mismatch. Rebuild with: 
    npm rebuild better-sqlite3

ARM64 compatibility:

  • ✅ Supported on Apple Silicon (M1/M2/M3)
  • ✅ Supported on Ubuntu ARM64
  • May require build from source on some platforms

Documentation

Community & Support

Have questions or ideas? We'd love to hear from you!

License

MIT (open-core). See LICENSE for details.

Built with Claude. Protected by Guardian.

README fetched from the repository 5 days ago. The original is authoritative.

Questions

About phuongrealmax/code-guardian

How do I install phuongrealmax/code-guardian?

Run uvx code-guardian-mcp, then add the server to your MCP client's configuration.

Is phuongrealmax/code-guardian safe to use with an AI agent?

Its trust score is 56 out of 100 (fair). It passes 3 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is phuongrealmax/code-guardian still maintained?

The last commit was 10 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.