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

Name: Argus
Author: athapong

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: SafetyCulture 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

Idioma	Herramientas	Instalación
Ir	gocyclo, golangci-lint	`go install github.com/fzipp/gocyclo/cmd/gocyclo@latest`
Java	PMD	macOS: `brew install pmd` , Linux: Instalación automática
Pitón	Pylint, Bandido	Instalación automática mediante dependencias
JavaScript	ESLint	`npm install -g eslint`

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