zero-harm-ai-mcp

# Zero Harm AI MCP Zero Harm AI MCP is a Model Context Protocol server that lets AI agents and runtime firewalls call Zero Harm AI safety checks for text, chat messages, prompts, tool inputs, and generated outputs. The server is a thin adapter over `zero-harm-ai-detectors`. It should not duplicate detector logic from the detector package or from the Zero Harm AI GitHub Action. ## Goals - Expose PII, secret, and harmful-content detection through MCP tools. - Return structured findings that agents and firewalls can enforce. - Support local/self-hosted operation for sensitive data. - Keep logs privacy-safe by default. - Provide stable tool contracts that can be used by coding agents, chat agents, and firewall. ## Non-Goals - Reimplementing `zero-harm-ai-detectors`. - Acting as a hosted service by default. - Making policy enforcement decisions that belong to a firewall or calling agent. - Replacing the Zero Harm AI GitHub Action. ## Relationship To Other Projects ```text zero-harm-ai-detectors Shared detector engine for PII, secrets, and harmful content. zero-harm-ai-gh-action GitHub Action and CI-oriented scanner for pull requests. zero-harm-ai-mcp MCP server adapter that exposes detector functionality to AI agents. zero-harm-ai-firewall (future) Runtime enforcement layer. It can call zero-harm-ai-mcp or use zero-harm-ai-detectors directly. ``` ## Installation Install from PyPI: ```bash pip install zero-harm-ai-mcp ``` For local development: ```bash python -m venv .venv source .venv/bin/activate pip install -e ".[dev]" pytest ruff check . ``` ## MCP Client Configuration ```json { "mcpServers": { "zero-harm-ai": { "command": "zero-harm-ai-mcp", "args": [] } } } ``` ## MCP Tools ### `zero_harm.scan_text` Scan one text string for PII, secrets, and harmful content. Use this for prompt inputs, generated outputs, tool arguments, logs, and arbitrary text. ### `zero_harm.scan_messages` Scan chat-style messages while pr…