zenable-mcp 1.0.0

MCP client for Zenable conformance checking

Zenable MCP Server

MCP (Model Context Protocol) server for code conformance checking. Integrates with AI development tools to validate generated code against organizational policies and best practices.

Features

• Real-time code validation against configurable policies
• Automatic file detection from IDE hooks
• Glob pattern support for checking multiple files (**/*.py)
• Integration with MCP-compatible agentic IDEs
• Command-line interface for standalone checking
• Lightweight Python package with minimal dependencies

Installation

# Set API key
export ZENABLE_API_KEY="your-api-key-here"

# Install and run zenable-mcp against your python files
uvx zenable-mcp check '**/*.py'

Usage

Command Line

Check files using glob patterns or automatic detection:

# Automatic detection from IDE hooks
zenable-mcp check

# Check a single file
zenable-mcp check example.py

# Check all Python files recursively
zenable-mcp check '**/*.py'

# Check multiple patterns
zenable-mcp check 'src/**/*.js' 'tests/**/*.js'

# Exclude test files
zenable-mcp check '**/*.py' --exclude '**/test_*.py'

# Specify a base directory for pattern matching
zenable-mcp check '**/*.py' --base-path ./src

Automatic File Detection

When running from IDE hooks, zenable-mcp check automatically detects files for Claude; if other IDEs support deterministic hook-based script calling and you'd like support, let us know!

This means hooks can simply run zenable-mcp check without specifying files.

IDE Integration

Zenable MCP integrates seamlessly with modern AI-powered development tools through hooks and automation.

Quick Setup

Claude Code - Add to .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "uvx zenable-mcp check"
          }
        ]
      }
    ]
  }
}

How It Works

1. File Analysis: Submits code to Zenable's conformance engine
2. Policy Validation: Checks against configured organizational policies
3. Result Reporting: Returns validation results with specific issues and suggestions

See our MCP Server Documentation for more details.

API Reference

Commands

• check <patterns...> - Validate files against conformance policies
  • Supports glob patterns (e.g., **/*.py, src/**/*.js)
  • Options:
    • --exclude: Patterns to exclude from checking
    • --base-path: Base directory for pattern matching
    • --verbose: Show files being checked
  • Returns: JSON response with validation results
  • Exit codes: 0 (pass), 1 (fail), 2 (error)

Documentation

• MCP Server Documentation
• Configure custom requirements
• Add automated PR reviews