Air Blackbox MCP server

<!-- mcp-name: io.github.airblackbox/air-blackbox-mcp -->

AIR Blackbox MCP Server

EU AI Act compliance scanning for Claude Desktop, Claude Code, Cursor, and any MCP-compatible client.

Unlike other compliance scanners that only report problems, AIR Blackbox also remediates - generating working code fixes, trust layer integrations, GDPR compliance checks, bias analysis, and full compliance reports. Under the hood, the scanning feeds into air-trust, a cryptographic audit chain (HMAC-SHA256) with Ed25519 signed handoffs that ensures compliance data integrity.

14 Tools (10 base + 4 SDK-powered)

Supported Frameworks

LangChain, CrewAI, AutoGen, OpenAI, Haystack, LlamaIndex, Semantic Kernel, Google ADK, Claude Agent SDK, and generic RAG pipelines.

Installation

Basic (10 tools, no SDK features)

pip install air-blackbox-mcp

Works standalone with just the lightweight built-in scanner.

Full (14 tools with GDPR, bias, validation, and history)

pip install air-blackbox-mcp[full]

Installs the full air-blackbox SDK (>=1.13,<2) for advanced compliance features. The floor is the version this package is tested against, and the major cap means a 2.x SDK cannot silently change your findings.

MCP SDK compatibility (mcp 2.0)

This package supports both MCP SDK generations — mcp>=1.0, no upper bound.

mcp 2.0 removed mcp.server.fastmcp and replaced FastMCP with MCPServer. Rather than pin away from it, the server detects which generation is installed and binds to the right class, so it runs on 1.x and 2.x alike:

Both paths are covered by tests that launch python -m airblackboxmcp as a real subprocess and drive it over stdio — the same way Claude Desktop and Cursor do — and the full suite runs green on both.

If you are on 0.2.3, upgrade. That version declared an unpinned mcp>=1.0.0, so once mcp 2.0 shipped, every fresh install produced a server that died on import:

ModuleNotFoundError: No module named 'mcp.server.fastmcp'

pip install --upgrade air-blackbox-mcp

0.2.4 fixed it by capping at mcp<2; 0.3.0 removes the cap entirely, so this server no longer conflicts with anything built for mcp 2.x sharing the same environment.

Claude Desktop Setup

Edit ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "air-blackbox": {
      "command": "python3",
      "args": ["-m", "air_blackbox_mcp"]
    }
  }
}

Restart Claude Desktop. The 14 tools will appear automatically.

Claude Code / Cursor Setup

Shortened. The full README is on GitHub.