JinDaGe - mcp-heimdall MCP Details

article

README

🛡️ 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文件与模板进行比较，并标记出缺失的键。
智能顾问：这是一个综合性工具，可针对环境问题提供具体的修复命令。

🛠️ 工具

| 工具 | 描述 | |------|-------------| | 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"]
    }
  }
}

开发者

克隆仓库。
安装依赖项：npm install。
构建项目：npm run build。
以开发模式运行：npm run dev。

📄 许可证

本项目采用MIT许可证。

mcp-heimdall