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

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

功能

• 多语言支持

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

• 安全性扫描

  • 集成 Trivy 漏洞扫描器
  • 全面的安全性报告
  • 支持多个分支

• Git 操作

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

安装

依赖项

• 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
}

支持的分析工具

环境变量

• SKIP_SYSTEM_CHECK：设置为任意值以跳过系统依赖检查
• PATH：自动更新工具安装路径

错误处理

该工具提供详细的错误消息和优雅的回退机制：

• 依赖项安装失败时显示警告而非错误
• 自动语言检测失败时回退到指定语言
• 工具执行错误被捕获在响应结构中

许可证

MIT License

贡献指南

1. 叉仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建新的拉取请求