Argus

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Performs static code analysis for JavaScript/TypeScript projects to identify code quality issues

  • Enables branch enumeration, commit history analysis, diff comparisons, and repository structure visualization

  • Allows repository analysis and security scanning for GitHub repositories

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

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

IdiomaHerramientasInstalación
Irgocyclo, golangci-lintgo install github.com/fzipp/gocyclo/cmd/gocyclo@latest
JavaPMDmacOS: brew install pmd , Linux: Instalación automática
PitónPylint, BandidoInstalación automática mediante dependencias
JavaScriptESLintnpm 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

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
-
security - not tested
A
license - permissive license
-
quality - not tested

Una herramienta de protocolo de contexto de modelo 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.

  1. Features
    1. Installation
      1. Prerequisites
      2. System Dependencies
      3. Installation via uv
    2. Usage
      1. Basic MCP Commands
    3. Supported Analysis Tools
      1. Environment Variables
        1. Error Handling
          1. License
            1. Contributing
              ID: emyammezhh