heimdall

🛡️ MCP Heimdall

Model Context Protocol（MCP）向けの高度な環境構築・診断ツールです。

Heimdall は、AI エージェントが実行環境を理解し、検証し、問題を修正できるよう支援します。システムアーキテクチャ、ランタイムのバージョン、依存関係、環境変数について詳細な情報を提供し、実行可能な修正案も提示します。

✨ 機能

• ワークスペースクリーナー：容量の大きいファイル（>50MB）や一時ディレクトリ（dist、build など）を見つけ、クリーンアップできます。
• パスインスペクター：PATH 変数を監査し、重要な開発ツール（git、brew、make）のバージョンを確認します。
• プロセスエクスプローラー：CPU／メモリを大量に消費するプロセスや、孤立した Node／Python プロセスの可能性があるものを特定します。
• Docker の確認：Docker デーモンの状態を確認し、コンテナーとイメージを一覧表示します。
• 接続チェック：重要なサービス（GitHub、NPM、Docker Hub）に ping を送信し、インターネット接続を確認します。
• プロジェクト診断：プロジェクトをスキャンし、NPM の脆弱性や古いパッケージを確認します。
• リソース監視：CPU 負荷、メモリ使用量、ディスク容量を監視します。
• ポート管理：アクティブなリスニングポートを一覧表示し、特定のポートを使用しているプロセスを終了します。
• ランタイムインスペクター：プロジェクトの要件に照らして、Node.js、Python、Java、Kotlin のバージョンを確認します。
• 依存関係ガード：node_modules や仮想環境が不足していないかを検出します。
• 環境監査：.env とテンプレートを比較し、不足しているキーを報告します。
• インテリジェントアドバイザー：環境の問題を修正するための具体的なコマンドを提案する統合ツールです。

🛠️ ツール

ツール	説明
system_info	OS とアーキテクチャの詳細を取得します。
inspect_runtimes	Node、Python、Java、Kotlin のバージョンを確認します。
inspect_docker	Docker デーモンの状態を確認し、コンテナーを一覧表示します。
check_connectivity	重要な開発サービスへのインターネット接続をテストします。
project_doctor	NPM の脆弱性や古いパッケージをスキャンします。
resource_watcher	CPU 負荷、メモリ、ディスクの使用状況を監視します。
workspace_janitor	クリーンアップ対象となる大容量ファイルや一時ディレクトリを見つけます。
path_inspector	システムの PATH と重要な開発ツールのバージョンを調べます。
process_explorer	リソースを大量に消費するプロセスや孤立したプロセスを特定します。
audit_dependencies	不足しているパッケージや破損した環境を検出します。
audit_env	.env ファイルをテンプレートと照合して検証します。
list_ports	アクティブなリスニングポートと、それらを使用するプロセスをすべて一覧表示します。
kill_port_process	特定のポートで実行中のプロセスを終了します。
suggest_corrections	中核機能：すべてのチェックを実行し、優先順位を付けた解決策を返します。

🚀 インストール

クイック統合

次のコマンドを実行すると、現在のワークスペースに Heimdall が自動的に設定されます。

npx @lchampz/mcp-heimdall integrate

これにより、正しい設定が記述された .vscode/mcp.json ファイルが作成されます。

ユーザー向け（MCP Registry 経由）

mcp.json またはエディターの設定に追加します。

{
  "servers": {
    "heimdall": {
      "command": "node",
      "args": ["path/to/mcp-heimdall/build/index.js"]
    }
  }
}

開発者向け

1. リポジトリをクローンします
2. 依存関係をインストールします：npm install
3. プロジェクトをビルドします：npm run build
4. 開発モードで実行します：npm run dev

📄 ライセンス

MIT