MCP Heimdall

🛡️ MCP Heimdall

MCP Heimdall是一款針對模型上下文協議（MCP）的高級環境架構與診斷工具。它能助力AI智能體理解、驗證並修復其執行環境。該工具可深入洞察系統架構、運行時版本、依賴項和環境變量，並提供切實可行的修正建議。

🚀 快速開始

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文件與模板進行比較，並標記出缺失的鍵。
• 智能顧問：這是一個綜合性工具，可針對環境問題提供具體的修復命令。

🛠️ 工具

📦 安裝指南

快速集成

運行以下命令，可在當前工作區自動配置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許可證。