heimdall

🛡️ MCP Heimdall

适用于模型上下文协议（MCP）的高级环境架构与诊断工具。

Heimdall 可帮助 AI Agent 了解、验证并修复其运行环境。它能详细展示系统架构、运行时版本、依赖项和环境变量，并提供可执行的修正建议。

✨ 功能

• 工作区清理器：查找大文件（>50MB）和临时目录（dist、build 等），以便清理。
• 路径检查器：审核 PATH 变量，并验证关键开发工具（git、brew、make）的版本。
• 进程浏览器：识别 CPU／内存占用最高的进程，以及可能成为孤儿的 Node／Python 进程。
• Docker 检查：检查 Docker 守护进程状态，并列出容器和镜像。
• 连接性检查：Ping 关键服务（GitHub、NPM、Docker Hub），以验证网络状态。
• 项目诊断：扫描项目中的 NPM 漏洞和过期软件包。
• 资源监视器：监控 CPU 负载、内存使用量和磁盘空间。
• 端口管理器：列出正在监听的端口，并终止占用指定端口的进程。
• 运行时检查器：根据项目要求验证 Node.js、Python、Java 和 Kotlin 版本。
• 依赖项守卫：检测是否缺少 node_modules 或虚拟环境。
• 环境审核：将 .env 与模板进行比较，并标记缺失的键。
• 智能顾问：整合工具，可建议用于修复环境问题的具体命令。

🛠️ 工具

工具	描述
system_info	获取操作系统和架构详情。
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