Skip to main content

MCP Security Guardian — SAST, Secrets, SCA, IaC scanning for AI-powered development

Project description

CodeMind — AI Security Guardian

   ___          _      __  __ _           _ 
  / __\___   __| | ___|  \/  (_)_ __   __| |
 / /  / _ \ / _` |/ _ \ |\/| | | '_ \ / _` |
/ /__| (_) | (_| |  __/ |  | | | | | | (_| |
\____/\___/ \__,_|\___|_|  |_|_|_| |_|\__,_|

🛡️ Enterprise-Grade Security for AI-Generated Code
Think before ship.

📦 PyPI📖 Documentation🚀 Quick Start🔧 Tools

PyPI Version Python MCP License Privacy


Technical Overview

CodeMind transforms your AI coding assistant (Cursor, Windsurf, Claude Desktop) into a full security platform. It provides real-time oversight of AI-generated code across five security dimensions.

Core Capabilities

Module Description
SAST Engine Detection of SQL injection, XSS, SSRF, and command injection patterns.
Secrets Detection Identification of hardcoded API keys and tokens with entropy analysis.
SCA (Dependencies) Scanning project lockfiles (12 formats) for CVEs via OSV.dev.
IaC Scanning Security auditing for Dockerfiles, GitHub Actions, and docker-compose.
SARIF Reporting Industry-standard output for CI/CD integration and GitHub Code Scanning.

Quick Start

Installation

# Global installation (recommended for CLI usage)
pip install codemind-mcp

IDE Configuration (MCP)

Add the following to your MCP server configuration:

{
  "mcpServers": {
"codemind": {
      "command": "codemind",
      "args": ["serve"]
    }
  }
}

Usage

Simply include the trigger phrase in your chat prompt:

"Generate a login endpoint for FastAPI. use codemind"

Instant SaaS Protection

When you use the use codemind trigger, the Guardian automatically enforces essential protections for modern SaaS applications:

  • Rate Limiting: Automatic protection against DDoS and brute-force attacks.
  • Data Isolation: Enforcement of Row Level Security (RLS) to ensure users only access their own data.
  • Input Integrity: Strict server-side validation using Zod or Pydantic.
  • Bot Protection: Seamless integration of CAPTCHA/Turnstile for public-facing forms.
  • Secure Defaults: Non-revealing error messages and secure CORS configurations.

Available Tools

CodeMind exposes 14 MCP tools for seamless automated workflows:

  • guard_code: Static analysis for vulnerabilities.
  • scan_secrets: Entropy-based credential detection.
  • scan_dependencies: Software Composition Analysis.
  • scan_iac_file: Infrastructure-as-Code auditing.
  • audit_launch_checklist: Production readiness verification.
  • deep_security_scan: Consolidated multi-layer analysis.

Strategic Roadmap

The transition from a hackathon project to a foundational security primitive.

Phase 1: Foundation (Vibeathon)

  • Initial MCP Server implementation.
  • Core SAST pattern matching (50+ rules).
  • Secrets detection and SCA integration.
  • Launch Readiness Checklist.

Phase 2: Intelligence (Post-Launch)

  • Semantic Analysis: Integration of tree-sitter for AST-based auditing.
  • Taint Tracking: Dataflow analysis to track untrusted input from source to sink.
  • Custom Rule DSL: YAML-based rule definition for community extensions.

Phase 3: Autonomy (Scale)

  • Agentic Remediation: Autonomous fix-verify loops for complex vulnerabilities.
  • CI/CD Native: Direct integration with GitHub Actions as a first-class citizen.
  • Enterprise Dashboard: Local analytics for team-wide security posture.

Phase 4: Expansion (Y Combinator Funding)

  • Universal Integration: Support for all major LLM providers and coding platforms.
  • Real-time Protection: Runtime monitoring for AI-agent executed tasks.
  • Global Standard: Becoming the default security layer for AI-driven software development.

Privacy Policy

CodeMind is built on the principle of Local-First Security.

  • Your source code never leaves your machine.
  • All pattern matching and analysis are performed locally.
  • SCA requests to OSV.dev contain only package names and versions.
  • No telemetry or tracking scripts are included.

License

Distributed under the MIT License. See LICENSE for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

codemind_mcp-2.1.0.tar.gz (137.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

codemind_mcp-2.1.0-py3-none-any.whl (144.6 kB view details)

Uploaded Python 3

File details

Details for the file codemind_mcp-2.1.0.tar.gz.

File metadata

  • Download URL: codemind_mcp-2.1.0.tar.gz
  • Upload date:
  • Size: 137.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for codemind_mcp-2.1.0.tar.gz
Algorithm Hash digest
SHA256 cd1a69748be8e20d526e7bf2f5a6ab854ff876d8cbdd4ff15bb23def866bd3de
MD5 4bae55b9fcd54125141ea240c2e437dd
BLAKE2b-256 9b91637f3d2190b53ada55d725f6441a92416ae0c39c94c4fb283624de539fc6

See more details on using hashes here.

File details

Details for the file codemind_mcp-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: codemind_mcp-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 144.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for codemind_mcp-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2d8421da86fee1e2cd6f909eaa2e2c419670f86247e626ee6976155adb9fc573
MD5 d32ce34c2265ad26726db744e1e9e783
BLAKE2b-256 842c7ae42675aa6e97c7bfbfb4f99556ef56e90e90abff1e4051906b08179850

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page