AIR Blackbox MCPサーバー

Claude Desktop、Claude Code、Cursor、およびMCP互換クライアント向けのEU AI法コンプライアンススキャンツールです。

問題を報告するだけの他のコンプライアンススキャナーとは異なり、AIR Blackboxは修正（レメディエーション）も行います。動作するコード修正の生成、トラストレイヤーの統合、GDPRコンプライアンスチェック、バイアス分析、および完全なコンプライアンスレポートの作成が可能です。内部的には、スキャン結果はair-trust（HMAC-SHA256による暗号化監査チェーン、Ed25519署名付きハンドオフ）に送られ、コンプライアンスデータの整合性が保証されます。

14個のツール（基本10個 + SDK拡張4個）

階層	ツール	機能	SDK必須
スキャン	`scan_code`	Pythonコード文字列をEU AI法の全6条項に基づきスキャン	いいえ
スキャン	`scan_file`	単一のPythonファイルを読み込みスキャン	いいえ
スキャン	`scan_project`	ディレクトリ内の全.pyファイルを再帰的にスキャン	いいえ
分析	`analyze_with_model`	ローカルのファインチューニング済みモデル（Ollama）による詳細分析	いいえ
分析	`check_injection`	プロンプトインジェクション攻撃を検出（15パターン）	いいえ
分析	`classify_risk`	ツールをEU AI法のリスクレベルで分類	いいえ
修正	`add_trust_layer`	トラストレイヤー統合コードを生成	いいえ
修正	`suggest_fix`	条項ごとの修正案を提示	いいえ
ドキュメント	`explain_article`	EU AI法条項の技術的解説	いいえ
ドキュメント	`generate_compliance_report`	完全なMarkdown形式のコンプライアンスレポート	いいえ
GDPR	`scan_gdpr`	GDPR固有のコンプライアンススキャン	はい
バイアス	`scan_bias`	バイアスおよび公平性の分析	はい
検証	`validate_action`	実行前にエージェントのアクションを検証（第14条）	はい
履歴	`compliance_history`	過去のスキャン、傾向、コンプライアンススコアの表示	はい

対応フレームワーク

LangChain、CrewAI、AutoGen、OpenAI、Haystack、LlamaIndex、Semantic Kernel、Google ADK、Claude Agent SDK、および汎用RAGパイプライン。

インストール

基本（10ツール、SDK機能なし）

pip install air-blackbox-mcp

軽量な組み込みスキャナーのみでスタンドアロン動作します。

フル（GDPR、バイアス、検証、履歴を含む14ツール）

pip install air-blackbox-mcp[full]

高度なコンプライアンス機能のために、完全な air-blackbox SDK (v1.6.3+) をインストールします。

Claude Desktopの設定

~/Library/Application Support/Claude/claude_desktop_config.json を編集します：

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

Claude Desktopを再起動すると、14個のツールが自動的に表示されます。

Claude Code / Cursorの設定

プロジェクト内の .cursor/mcp.json に追加します：

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

または、Claude Code用に .claude/mcp.json に追加します。

使用例

Claude Desktop、Claude Code、またはCursorで以下のように質問してください：

"Scan this code for EU AI Act compliance"
"Add a trust layer to this LangChain agent"
"Check this text for prompt injection"
"What does Article 12 require?"
"Generate a compliance report for ~/myproject"
"Classify the risk level of send_email"
"Scan this code for GDPR issues" (フルSDKが必要)
"Check for bias in this AI model code" (フルSDKが必要)
"Can my agent call this shell function?" (フルSDKが必要)
"Show me my compliance trends" (フルSDKが必要)

SDK機能（オプション）

完全な air-blackbox SDKは、以下の4つの追加ツールを有効にします：

GDPRスキャン (scan_gdpr)
- 同意なしの個人データ取り扱い
- データ保持および削除ポリシー
- 国境を越えたデータ転送の保護措置
- データ処理契約
バイアス分析 (scan_bias)
- 不当な影響（Disparate impact）のリスク検出
- 保護対象属性の取り扱い
- 学習データのバイアス指標
- 公平性メトリクスの認識
アクション検証 (validate_action)
- 実行前の承認ゲート（第14条）
- ConsentGateポリシーの強制
- リスクベースのアクションフィルタリング
- 監査証跡の生成
コンプライアンス履歴 (compliance_history)
- 過去のスキャン結果の追跡
- コンプライアンス傾向の分析
- 監査証跡のエクスポート
- 時間経過に伴う改善の監視

オプション：Ollamaによる詳細分析

正規表現パターンを超えたAIによる分析を行う場合：

# Install Ollama
brew install ollama

# Pull the fine-tuned compliance model
ollama pull air-compliance-v2

# The analyze_with_model tool will automatically use it

他との違い

他のMCPコンプライアンスツールはスキャンのみですが、AIR Blackboxは以下の特徴があります：

スキャン + 修正 — EU AI法の6つの条項にわたる問題を特定し、動作するコード修正を生成します
詳細な分析 — 正規表現パターン + AIモデルによる分析 + プロンプトインジェクション検出（15パターン）
実行前の検証 — エージェントアクションに対する事前承認ゲートとリスク分類（第14条）
コンプライアンス追跡 — GDPRチェック、バイアス分析、完全なレポート、および履歴傾向の監視（SDK）

アーキテクチャ

サーバーはスマートなフォールバックパターンを使用しています：

SDKを優先 — air-blackbox>=1.6.0 がインストールされている場合、完全なコンプライアンスエンジンを使用します
適切にフォールバック — SDKがインストールされていない場合、軽量な組み込みスキャナーを使用します
破壊的変更なし — pip install air-blackbox-mcp だけで動作します（基本モード）
オプトインの強力な機能 — [full] をインストールして高度な機能を解放します

つまり、MCPサーバーはスタンドアロンで動作しますが、SDKが存在すると劇的に強力になります。

AIR Blackboxの一部

このMCPサーバーは AIR Blackboxエコシステム の一部です：

air-trust (PyPI) — コンプライアンススキャンを支える暗号化監査チェーン
air-blackbox (PyPI) — 完全なコンプライアンスSDKおよびCLIスキャナー
airblackbox.ai — プロジェクトのホームページおよびドキュメント

リンク

EU AI Act — 規制原文
GDPR — データ保護規制

air-blackbox-mcp