Secure Annex MCP

🚀 安全附件 MCP 服務器

安全附件 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. 監控廣告攔截規則，確保無誤報。

📚 詳細文檔

API 文檔

接口列表

1. get_extension_info：
   • 獲取指定擴展的基本信息。
2. check_vulnerabilities：
   • 檢查指定擴展的已知漏洞。
3. analyze_behavior：
   • 分析擴展的行為模式。
4. query_statistics：
   • 查詢擴展的歷史使用統計數據。

請求格式

{
  "name": "接口名稱",
  "arguments": {
    "參數名": "參數值"
  }
}

響應格式

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

配置指南

1. 獲取 API Key：
   • 訪問 安全附件控臺。
   • 登錄後進入“開發者設置”獲取 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 問題 提交 bug 或功能需求。
2. 參與開發：
   • Fork 倉庫，創建功能分支。
   • 提交 Pull Request 進行代碼審查和合並。

📄 許可證

項目基於 MIT 許可證開源，歡迎自由使用和修改。