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许可证。