Argus - Herramienta de análisis de repositorios y evaluación de seguridad

Una poderosa herramienta de Protocolo de Contexto de Modelo (MCP) para analizar repositorios de código, realizar análisis de seguridad y evaluar la calidad del código en múltiples lenguajes de programación.

Características

• Soporte multilingüe

  • Go: gocyclo, análisis de golangci-lint

  • Java: análisis estático de PMD

  • Python: controles de seguridad de Pylint y Bandit

  • JavaScript/TypeScript: análisis de ESLint

  • Detección automática del idioma

• Escaneo de seguridad

  • Escáner de vulnerabilidades Trivy integrado

  • Informes de seguridad completos

  • Soporte para múltiples sucursales

• Operaciones de Git

  • Enumeración y gestión de sucursales

  • Análisis del historial de confirmaciones

  • Comparaciones de diferencias

  • Visualización de la estructura del repositorio

Related MCP server: CodeAnalysis MCP Server

Instalación

Prerrequisitos

• Python 3.8+

• Git

• libmagic (dependencia del sistema)

Dependencias del sistema

macOS

brew install libmagic

Linux (Ubuntu/Debian)

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

Instalación mediante uv

uvx argus

Uso

Comandos básicos de 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
}

Herramientas de análisis compatibles

Variables de entorno

• SKIP_SYSTEM_CHECK : Establezca cualquier valor para omitir las comprobaciones de dependencia del sistema

• PATH : Se actualiza automáticamente para las instalaciones de herramientas

Manejo de errores

La herramienta proporciona mensajes de error detallados y alternativas elegantes:

• Los fallos de instalación de dependencias muestran advertencias en lugar de errores

• La detección del idioma vuelve al idioma especificado si falla la detección automática

• Los errores de ejecución de la herramienta se capturan en la estructura de respuesta

Licencia

Licencia MIT

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una nueva solicitud de extracción