Argus - Repository Analysis and Security Assessment Tool

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
analyze_repository_structure(
    repo_url="https://gitlab.com/user/repo",
    gitlab_credentials={"api_key": "your-token"},  # Optional
    branch="main"  # Optional
)

# Perform code quality analysis
analyze_code_quality(
    repo_url="https://gitlab.com/user/repo",
    language="python"  # Optional, will auto-detect if not specified
)

# Security scan
security_scan_repository(
    repo_url="https://gitlab.com/user/repo",
    scan_type="trivy"
)

# Compare changes
compare_git_changes(
    repo_url="https://gitlab.com/user/repo",
    source="feature-branch",
    target="main"
)

# Security scan repository
security_scan_repository(
    repo_url="https://gitlab.com/user/repo",
    scan_type="trivy"
)

### MCP Configuration

```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