SecureAnnex MCP Server

---

SecureAnnex MCP サーバー

ブラウザー拡張機能のセキュリティを分析するための、Model Context Protocol（MCP）サーバーです。このサーバーは、脆弱性の検出、署名のチェック、コードレビューなど、ブラウザー拡張機能のセキュリティに関する項目を照会、分析、評価するツールを提供します。

クイックセットアップ

Python 環境を手動でセットアップする必要はありません。この MCP サーバーは Claude Desktop で動作するよう設計されており、uv パッケージマネージャーと付属の pyproject.toml ファイルを使用して、すべての依存関係を自動的に処理します。

開始するには、以下の手順に従ってください。

1. このリポジトリをダウンロードまたはクローンします
2. pyproject.toml ファイルがプロジェクトディレクトリにあることを確認します
3. 以下の手順に従って Claude Desktop を設定します
4. 任意：Claude が uv コマンドを見つけられない場合は、代わりに絶対パスを使用します。ターミナルで which uv を実行すると、絶対パスを確認できます。

Claude Desktop の設定

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

{
  "mcpServers": {
    "secureannex": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/secure-annex-mcp",
        "run",
        "secure_annex_mcp"
      ],
      "env": {
        "SECUREANNEX_API_KEY": "your_api_key_here"
      }
    }
  }
}

注：/path/to/secure-annex-mcp を SecureAnnex MCP サーバーディレクトリの絶対パスに置き換えてください。

プロジェクト構成

secure-annex-mcp/
├── pyproject.toml         # Package configuration
├── README.md              # Project documentation
└── secure_annex_mcp/      # Main package
    ├── __init__.py        # Package initialization
    ├── __main__.py        # Entry point when run as a module
    └── server.py          # MCP server implementation

利用可能なツール

拡張機能の検索と情報

• search_extensions：さまざまな条件に基づいてブラウザー拡張機能を検索します

  • パラメーター：name、extension_id、owner、featured、active、page、page_size

• get_extension_details：特定の拡張機能の詳細情報を取得します

  • パラメーター：extension_id（必須）

• get_extension_versions：特定の拡張機能のバージョン履歴を取得します

  • パラメーター：extension_id（必須）、version

セキュリティ分析

• get_extension_vulnerabilities：特定の拡張機能のセキュリティ脆弱性を取得します

  • パラメーター：extension_id（必須）、version

• get_extension_signatures：特定の拡張機能のセキュリティシグネチャを取得します

  • パラメーター：extension_id（必須）、version、rule

• get_extension_urls：特定の拡張機能が使用するネットワーク URL を取得します

  • パラメーター：extension_id（必須）、version、domain

• get_extension_manifest_risks：特定の拡張機能のマニフェスト権限に関するリスクを取得します

  • パラメーター：extension_id（必須）、version、risk_type

• get_extension_analysis：特定の拡張機能の AI セキュリティ分析を取得します

  • パラメーター：extension_id（必須）

• get_extension_code_review：特定の拡張機能のコードセキュリティレビューを取得します

  • パラメーター：extension_id（必須）、version

ユーザーフィードバック

• get_extension_reviews：特定の拡張機能に関するユーザーレビューを取得します
  • パラメーター：extension_id（必須）、rating

更新情報

• get_recent_updates：最近更新された拡張機能を取得します
  • パラメーター：なし

使用例

Claude でツールを使用する実践的な例を紹介します。

拡張機能を検索する

# Get all extensions developed by specific developer
I need to find all extensions by [email protected]

# Claude would use:
{
  "name": "search_extensions",
  "arguments": {
    "owner": "[email protected]"
  }
}

セキュリティ分析

# Get all security signatures for an extension
Show me all security signatures for the AdBlock extension

# Claude would use:
{
  "name": "get_extension_signatures",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

# Extract all network domains from an extension
Extract all domains embedded in the AdBlock extension

# Claude would use:
{
  "name": "get_extension_urls",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

# Analyze manifest permissions
Show me a table of all permissions requested by AdBlock with explanations

# Claude would use:
{
  "name": "get_extension_manifest_risks",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

他の MCP との統合

# Leveraging VirusTotal MCP for domain reputation
Can you extract all domains from the AdBlock extension and check their reputation on VirusTotal?

# Claude would use both SecureAnnex and VirusTotal MCPs:
# 1. First, get domains from SecureAnnex
{
  "name": "get_extension_urls",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

# 2. Then for each domain, check VirusTotal
{
  "name": "domain_report",  // VirusTotal MCP tool
  "arguments": {
    "domain": "example.com"  // For each domain found
  }
}

# 3. Claude would compile results into a table:
| Domain | Reputation | Detection Ratio | Categories |
|--------|------------|-----------------|------------|
| domain1.com | Clean | 0/85 | Advertising |
| domain2.com | Suspicious | 3/85 | Marketing |

包括的な分析

# Request a complete security review of an extension
Perform a full security audit of the AdBlock extension

# Claude would combine multiple tools:
{
  "name": "get_extension_details",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

{
  "name": "get_extension_vulnerabilities",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

{
  "name": "get_extension_analysis",
  "arguments": {
    "extension_id": "gighmmpiobklfepjocnamgkkbiglidom"
  }
}

API キー

SecureAnnex MCP サーバーが SecureAnnex API で認証を行うには、API キーが必要です。SecureAnnex サービスから API キーを取得し、上記のとおり Claude Desktop の設定に含めてください。

トラブルシューティング

問題が発生した場合は、以下を確認してください。

1. 環境変数に API キーが正しく設定されていることを確認します
2. Claude Desktop の設定に記載されたパスが正しいことを確認します