AI导哈

环境诊断工具

Heimdall是一款高级环境架构与诊断工具，帮助AI代理理解、验证和修复其执行环境，提供系统架构、运行时版本、依赖项和环境变量的详细分析及可操作的修正建议。

  • by lchampz
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 lchampz/mcp-heimdall

使用说明

🛡️ MCP海姆达尔

模型上下文协议（MCP）的高级环境架构师和诊断工具。

Heimdall帮助AI代理了解、验证和修复其执行环境。它提供了对系统架构、运行时版本、依赖关系和环境变量的详细见解，以及可操作的纠正建议。

✨ 特性

  • 工作区清洁工：查找大文件（>50MB）和临时目录(dist, build等）进行清理。
  • 路径检查器：审核 PATH 关键开发工具的变量和验证版本(git, brew, make).
  • 进程管理：识别顶级CPU/内存消耗者和潜在的孤立Node/Python进程。
  • Docker Sight：检查Docker守护进程状态，列出容器和映像。
  • 连接检查：Ping基本服务（GitHub、NPM、Docker Hub）以验证互联网状态。
  • 项目博士：扫描Project以查找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注册表）

添加到您的 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

📄 许可证

麻省理工学院

相关 MCP