Argus

🚀 Argus - コードリポジトリ分析とセキュリティ評価ツール

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設定

{
    "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. 新しいプルリクエストを作成する