# Assess Existing Codebase with Zenable MCP
Use Zenable's MCP (Model Context Protocol) server to analyze and assess your existing codebase for conformance with organizational policies and best practices. Quickly identify areas that need improvement and ensure consistency across your entire project.
## 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
```bash
# 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:
```bash
# Automatic detection from IDE hooks
uvx zenable-mcp check
# Check a single file
uvx zenable-mcp check example.py
# Check all Python files recursively
uvx zenable-mcp check '**/*.py'
# Check multiple patterns
uvx zenable-mcp check 'src/**/*.js' 'tests/**/*.js'
# Exclude test files
uvx zenable-mcp check '**/*.py' --exclude '**/test_*.py'
# Specify a base directory for pattern matching
uvx 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](https://zenable.io/feedback)!
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`:
```json
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "uvx zenable-mcp@1.1.0 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](https://docs.zenable.io/integrations/mcp) 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](https://docs.zenable.io/integrations/mcp)
- [Configure custom requirements](https://www.zenable.app)
- [Add automated PR reviews](https://docs.zenable.io/integrations/github)
Raw data
{
"_id": null,
"home_page": null,
"name": "zenable-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "mcp, claude, hooks, conformance, zenable, code-quality, security, compliance, policy-as-code, specifications, spec-driven-development",
"author": null,
"author_email": "Zenable <Python@zenable.io>",
"download_url": null,
"platform": null,
"description": "# Assess Existing Codebase with Zenable MCP\n\nUse Zenable's MCP (Model Context Protocol) server to analyze and assess your existing codebase for conformance with organizational policies and best practices. Quickly identify areas that need improvement and ensure consistency across your entire project.\n\n## Features\n\n- Real-time code validation against configurable policies\n- Automatic file detection from IDE hooks\n- Glob pattern support for checking multiple files (`**/*.py`)\n- Integration with MCP-compatible agentic IDEs\n- Command-line interface for standalone checking\n- Lightweight Python package with minimal dependencies\n\n## Installation\n\n```bash\n# Set API key\nexport ZENABLE_API_KEY=\"your-api-key-here\"\n\n# Install and run zenable-mcp against your python files\nuvx zenable-mcp check '**/*.py'\n```\n\n## Usage\n\n### Command Line\n\nCheck files using glob patterns or automatic detection:\n\n```bash\n# Automatic detection from IDE hooks\nuvx zenable-mcp check\n\n# Check a single file\nuvx zenable-mcp check example.py\n\n# Check all Python files recursively\nuvx zenable-mcp check '**/*.py'\n\n# Check multiple patterns\nuvx zenable-mcp check 'src/**/*.js' 'tests/**/*.js'\n\n# Exclude test files\nuvx zenable-mcp check '**/*.py' --exclude '**/test_*.py'\n\n# Specify a base directory for pattern matching\nuvx zenable-mcp check '**/*.py' --base-path ./src\n```\n\n#### Automatic File Detection\n\nWhen running from IDE hooks, `zenable-mcp check` automatically detects files for Claude; if other IDEs support deterministic hook-based script calling and you'd\nlike support, [let us know](https://zenable.io/feedback)!\n\nThis means hooks can simply run `zenable-mcp check` without specifying files.\n\n### IDE Integration\n\nZenable MCP integrates seamlessly with modern AI-powered development tools through hooks and automation.\n\n#### Quick Setup\n\n**Claude Code** - Add to `.claude/settings.json`:\n\n```json\n{\n \"hooks\": {\n \"PostToolUse\": [\n {\n \"matcher\": \"Write|Edit\",\n \"hooks\": [\n {\n \"type\": \"command\",\n \"command\": \"uvx zenable-mcp@1.1.0 check\"\n }\n ]\n }\n ]\n }\n}\n```\n\n## How It Works\n\n1. **File Analysis**: Submits code to Zenable's conformance engine\n2. **Policy Validation**: Checks against configured organizational policies\n3. **Result Reporting**: Returns validation results with specific issues and suggestions\n\nSee our [MCP Server Documentation](https://docs.zenable.io/integrations/mcp) for more details.\n\n## API Reference\n\n### Commands\n\n- `check <patterns...>` - Validate files against conformance policies\n - Supports glob patterns (e.g., `**/*.py`, `src/**/*.js`)\n - Options:\n - `--exclude`: Patterns to exclude from checking\n - `--base-path`: Base directory for pattern matching\n - `--verbose`: Show files being checked\n - Returns: JSON response with validation results\n - Exit codes: 0 (pass), 1 (fail), 2 (error)\n\n## Documentation\n\n- [MCP Server Documentation](https://docs.zenable.io/integrations/mcp)\n- [Configure custom requirements](https://www.zenable.app)\n- [Add automated PR reviews](https://docs.zenable.io/integrations/github)\n",
"bugtrack_url": null,
"license": "Proprietary",
"summary": "MCP client for Zenable conformance checking",
"version": "1.2.0",
"project_urls": {
"Documentation": "https://docs.zenable.io/",
"Homepage": "https://zenable.io",
"Issues": "https://zenable.io/feedback"
},
"split_keywords": [
"mcp",
" claude",
" hooks",
" conformance",
" zenable",
" code-quality",
" security",
" compliance",
" policy-as-code",
" specifications",
" spec-driven-development"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ab3ba239a14bb3fd0718a5a5c7ee763d89524d32049161b96e1b8ef99549db22",
"md5": "ff068b9a035de3dc8054364355eaf4fe",
"sha256": "8c9b1b0c56fc6fa80bb39e0337f268f5fdafffa744491550c1bfd83fa16feacf"
},
"downloads": -1,
"filename": "zenable_mcp-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ff068b9a035de3dc8054364355eaf4fe",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 22417,
"upload_time": "2025-08-14T22:23:22",
"upload_time_iso_8601": "2025-08-14T22:23:22.324242Z",
"url": "https://files.pythonhosted.org/packages/ab/3b/a239a14bb3fd0718a5a5c7ee763d89524d32049161b96e1b8ef99549db22/zenable_mcp-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-14 22:23:22",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "zenable-mcp"
}
JSON