Secure Annex MCP

🚀 SecureAnnex MCP サーバ

このサーバは、ブラウザ拡張機能の安全性を分析するためのモデルコントローラプロトコル（MCP）サーバです。MIT ライセンスの下で公開されており、pyproject.toml ファイルを構成することで Claude Desktop 環境での実行方法を示しています。

🚀 クイックスタート

1. リポジトリのダウンロードまたはクローン：GitHub や他のコードホスティングプラットフォームからプロジェクトを取得します。
2. Claude Desktop の設定：
   • config.json ファイルを開きます。
   • "mcp.servers" セクションに以下の内容を追加します。

"SecureAnnex": {
  "command": "poetry run secure-annex-server",
  "env": {
    "SECURE_ANNEX_API_KEY": "your_api_key_here"
  }
}

3. サービスの起動：
   • ターミナルを開き、プロジェクトのルートディレクトリに移動します。
   • poetry install を実行して依存関係をインストールします。
   • サーバを起動します：poetry run secure-annex-server start。

📁 プロジェクト構造

.
├── pyproject.toml         # プロジェクトの依存関係とスクリプトの設定
├── src/
│   ├── __init__.py       # パッケージ識別用の空ファイル
│   └── server.py         # メインサーバのロジック
└── README.md             # プロジェクトドキュメント

✨ 主な機能

コア機能

1. 拡張機能情報の照会：

   • 指定された extension_id の詳細情報を取得します。
   • 返される結果には、拡張機能の基本情報、開発者情報、バージョン履歴が含まれます。

2. セキュリティホールの検出：

   • 指定された拡張機能の既知のホールをスキャンします。
   • 返される結果には、ホール ID、深刻度レベル、修復提案が含まれます。

3. 動作分析：

   • 拡張機能の動作パターンを分析します。
   • 潜在的なリスクを評価するためのレポートを生成します。

高度な機能

1. 履歴データ分析：

   • 拡張機能の過去の使用記録を照会します。
   • ユーザー分布と時間的な傾向のグラフを提供します。

2. API 呼び出しの統合：

   • 他の MCP（VirusTotal など）との相互作用をサポートします。
   • 結合分析結果を返し、さらなる処理を容易にします。

💻 使用例

基本的な使用法

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

応答：

{
  "id": "gighmmpiobklfepjocnamgkkbiglidom",
  "name": "uBlock Origin",
  "developer": "Maximer",
  "version": "1.20.7",
  "description": "A lightweight, open-source ad blocker.",
  "permissions": ["activeTab", "scripting"],
  "last_update": "2023-10-05"
}

高度な使用法

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

応答：

## 基本情報
- ID: gighmmpiobklfepjocnamgkkbiglidom
- 名称: uBlock Origin
- 開発者: Maximer
- バージョン: 1.20.7

## セキュリティホール
- 検出された高リスクホール: 0 個。

## 動作分析
- 要求された権限: activeTab, scripting
- 拡張機能: 広告ブロック、スクリプト注入
- リスクレベル: 低リスク

## 提案
1. 最新のセキュリティパッチを取得するために、定期的に拡張機能を更新してください。
2. 誤検知がないことを確認するために、広告ブロックルールを監視してください。

📚 ドキュメント

インターフェース一覧

1. get_extension_info：

   • 指定された拡張機能の基本情報を取得します。

2. check_vulnerabilities：

   • 指定された拡張機能の既知のホールをチェックします。

3. analyze_behavior：

   • 拡張機能の動作パターンを分析します。

4. query_statistics：

   • 拡張機能の過去の使用統計データを照会します。

リクエスト形式

{
  "name": "インターフェース名",
  "arguments": {
    "パラメータ名": "パラメータ値"
  }
}

レスポンス形式

{
  "status": "success",
  "data": {},
  "message": ""
}

🛠️ 設定ガイド

1. API キーの取得：

   • SecureAnnex コンソールにアクセスします。
   • ログイン後、「開発者設定」に入り、API キーを取得します。

2. 環境変数の設定：

export SECURE_ANNEX_API_KEY="your_api_key_here"

3. サーバの起動：
   • Poetry で依存関係を管理します。
   • poetry run secure-annex-server start を実行してサービスを起動します。

🎯 プロジェクト目標

1. 標準化された拡張機能分析インターフェースを提供する。
2. 他のセキュリティツール（VirusTotal など）との統合をサポートする。
3. オープンなセキュリティ研究エコシステムを構築する。

🤝 コントリビューションガイド

1. 問題の提出：

   • GitHub Issues でバグや機能要求を提出します。

2. 開発への参加：

   • リポジトリを Fork し、機能ブランチを作成します。
   • コードレビューとマージのために Pull Request を送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソース化されており、自由に使用および修正することができます。