MCP Heimdall

🛡️ MCP Heimdall

モデルコンテキストプロトコル（MCP）用の高度な環境構築と診断ツールです。Heimdallは、AIエージェントが実行環境を理解、検証、修正するのを支援します。システムアーキテクチャ、ランタイムバージョン、依存関係、環境変数に関する詳細な情報を提供し、実行可能な修正提案も併せて提供します。

🚀 クイックスタート

Heimdallを使用することで、AIエージェントの実行環境の問題を迅速に特定し、解決することができます。以下のセクションでは、Heimdallの主な機能、ツール、インストール方法について説明します。

✨ 主な機能

• ワークスペースクリーナー：大きなファイル（>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ファイルをテンプレートと比較し、欠落しているキーをフラグ付けします。
• インテリジェントアドバイザー：環境問題を解決するための特定のコマンドを提案する統合ツールです。

🛠️ ツール

📦 インストール

クイック統合

現在のワークスペースにHeimdallを自動的に構成するには、次のコマンドを実行します。

npx @lchampz/mcp-heimdall integrate

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

ユーザー向け（MCPレジストリ経由）

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