Skip to main content

🐕 MCP Cybersec Watchdog

Complete Linux security audit in 30 seconds via Claude MCP. Zero configuration required.

License: MIT Python 3.10+ Tests codecov PyPI Code style: black

Features

One-Time Audit (23 analyzers, 89 CIS controls)

  • Firewall, SSH, fail2ban, Docker, SSL certificates
  • CVE scanning, container image scanning (trivy)
  • Compliance: CIS Benchmark, NIST 800-53, PCI-DSS v4.0
  • Kernel hardening, MAC (AppArmor/SELinux), rootkit detection
  • Multi-level scoring (personal/business/corporate/military)

Live Monitoring (Beta)

  • Background daemon with anomaly detection
  • Alerts on firewall changes, new ports, attack spikes, compliance drift
  • AI analysis only when needed (token-efficient)

Quick Start

# Install
pip install mcp-cybersec-watchdog

# Setup passwordless sudo (required)
bash <(curl -s https://raw.githubusercontent.com/girste/mcp-cybersec-watchdog/main/setup-sudo.sh)

# Run audit
mcp-watchdog test

# Start monitoring (checks every hour)
mcp-watchdog monitor

Claude Desktop Integration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cybersec-watchdog": {
      "command": "/path/to/venv/bin/mcp-watchdog"
    }
  }
}

Example prompts:

Run a security audit on this server
Start monitoring with 30 minute intervals
Show monitoring status

MCP Tools

Tool Description
security_audit Comprehensive one-time audit
start_monitoring Start background monitoring
stop_monitoring Stop daemon
monitoring_status Check status and recent bulletins
analyze_anomaly AI analysis of detected anomalies

Output Example

{
  "analysis": {
    "overall_status": "GOOD",
    "profile_scores": {
      "personal": 93.3,
      "business": 88.8,
      "corporate": 83.8,
      "military": 82.2
    }
  },
  "firewall": {"type": "ufw", "active": true, "open_ports": [80, 443, 22]},
  "cis_benchmark": {"compliance_percentage": 78.3},
  "nist_800_53": {"compliance_percentage": 80.0},
  "pci_dss": {"compliance_percentage": 100.0},
  "threats": {"total_attempts": 342, "unique_ips": 89},
  "recommendations": [...]
}

Privacy: IPs/hostnames masked by default. Disable with {"mask_data": false}.

Configuration (Optional)

Create .mcp-security.json to customize checks:

{
  "checks": {
    "firewall": true,
    "ssh": true,
    "cis": true,
    "docker": false
  },
  "threat_analysis_days": 14
}

Development

git clone https://github.com/girste/mcp-cybersec-watchdog
cd mcp-cybersec-watchdog
pip install -e ".[dev]"
pytest tests/ -v

Contributing

See CONTRIBUTING.md for guidelines.

Security

Report vulnerabilities via SECURITY.md.

License

MIT - see LICENSE


Created by Girste • Issues

Metadata

Release files for mcp-cybersec-watchdog 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-cybersec-watchdog 0.1.0
File Size Uploaded
mcp_cybersec_watchdog-0.1.0.tar.gz 84.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-cybersec-watchdog 0.1.0
File Interpreter ABI Platform
mcp_cybersec_watchdog-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 174.1 kB

Release files / mcp_cybersec_watchdog-0.1.0.tar.gz

Download URL mcp_cybersec_watchdog-0.1.0.tar.gz
Size 84.2 kB
Tags Source
SHA-256 checksum
How to use checksums
90d2597902d40e26bcef4fb7faba18465a618733e8875ed7d0707e615eb66837
BLAKE2b-256 checksum
How to use checksums
4eb28d9de49b384c9d64ef2e36f6c5dea08bbd5ff74be050d54fd11a9d7adc73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / mcp_cybersec_watchdog-0.1.0-py3-none-any.whl

Download URL mcp_cybersec_watchdog-0.1.0-py3-none-any.whl
Size 89.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
37e5d12a9603473c09c883162c88787728cc739d46eb464706b635e960c9c049
BLAKE2b-256 checksum
How to use checksums
5a5e02b3477dd27a7978a4e8a40717e76d051a8984acdd0093d3d35192193d8e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page