Argus - 仓库分析与安全评估工具

一个强大的模型上下文协议 (MCP) 工具，用于分析代码仓库、执行安全扫描以及评估跨多种编程语言的代码质量。

功能

• 多语言支持

  • Go: gocyclo, golangci-lint 分析
  • Java: PMD 静态分析
  • Python: Pylint, Bandit 安全检查
  • JavaScript/TypeScript: ESLint 分析
  • 自动语言检测

• 安全扫描

  • 集成 Trivy 漏洞扫描器
  • 综合安全报告
  • 支持多个分支

• Git 操作

  • 分支枚举和管理
  • 提交历史分析
  • Diff 比较
  • 仓库结构可视化

安装

前提条件

• Python 3.8+
• Git
• libmagic (系统依赖)

系统依赖

macOS

brew install libmagic

Linux (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install -y libmagic1

通过 uv 安装

uvx argus

使用

基本 MCP 命令

# 分析仓库结构
analyze_repository_structure(
    repo_url="https://gitlab.com/user/repo",
    gitlab_credentials={"api_key": "your-token"},  # 可选
    branch="main"  # 可选
)

# 执行代码质量分析
analyze_code_quality(
    repo_url="https://gitlab.com/user/repo",
    language="python"  # 可选，如果未指定，将自动检测
)

# 安全扫描
security_scan_repository(
    repo_url="https://gitlab.com/user/repo",
    scan_type="trivy"
)

# 比较更改
compare_git_changes(
    repo_url="https://gitlab.com/user/repo",
    source="feature-branch",
    target="main"
)

# 安全扫描仓库
security_scan_repository(
    repo_url="https://gitlab.com/user/repo",
    scan_type="trivy"
)

### MCP 配置

```json
{
    "command": "uvx",
    "args": [
        "--from",
        "git+https://github.com/athapong/argus",
        "argus"
    ],
    "alwaysAllow": [
        "get_commit_history",
        "enumerate_branches",
        "compare_git_changes",
        "analyze_code_quality",
        "security_scan_repository"  
    ],
    "timeout": 300
}

支持的分析工具

语言	工具	安装
Go	gocyclo, golangci-lint	go install github.com/fzipp/gocyclo/cmd/gocyclo@latest
Java	PMD	macOS: brew install pmd, Linux: 自动安装
Python	Pylint, Bandit	通过依赖自动安装
JavaScript	ESLint	npm install -g eslint

环境变量

• SKIP_SYSTEM_CHECK: 设置为任何值以跳过系统依赖检查
• PATH: 自动更新以进行工具安装

错误处理

该工具提供详细的错误消息和优雅的降级：

• 依赖安装失败显示警告而不是错误
• 如果自动检测失败，语言检测将回退到指定的语言
• 工具执行错误会被捕获在响应结构中

许可证

MIT 许可证

贡献

1. Fork 仓库
2. 创建您的特性分支
3. 提交您的更改
4. 推送到分支
5. 创建一个新的 Pull Request