Heimdall

io.github.lchampz由 GitHub 账号 lchampz 发布v1.0.1更新于 Oct 24, 2026

🛡️ MCP Heimdall - Advanced Environment Architect & Diagnostic Tool.

已验证STDIO仅桌面云端与基础设施开发者工具安全与监控

概览

AI 生成的概览

一个本地 MCP 服务器，用于检查开发机器的环境——运行时、PATH、Docker、端口、进程、资源和项目依赖——并给出修复建议。

可以做什么
检查系统：操作系统与架构信息，Node、Python、Java、Kotlin 版本，PATH 条目与关键开发工具版本，Docker 守护进程状态及容器和镜像，以及到 GitHub、NPM、Docker Hub 等服务的连通性。审计项目：扫描 NPM 漏洞和过时依赖，检测缺失的 node_modules 或虚拟环境，并将 .env 文件与模板比对以标出缺失的键。监控资源：CPU 负载、内存与磁盘占用、占用资源最多的进程和孤立进程，以及正在监听的端口。清理与修复：查找大文件和临时构建目录，结束占用指定端口的进程，并运行全部检查以获得按优先级排序的修复建议。
适用场景
适合在助手需要诊断本地项目为何无法构建或运行时使用，也可用于核对已安装工具版本是否符合要求、检查 Docker 或网络连通性，或为损坏的开发环境获取具体修复建议。
运行要求
作为本地进程在用户机器上运行，从 npm 包安装并用 Node.js 启动。仅限桌面，不支持网页执行。可选设置 DEBUG 环境变量以启用调试日志。未声明任何身份验证。
安装前请注意
该服务器会读取本地系统和项目信息（包括环境文件）并发送给助手。它可以结束占用端口的进程，并列出可清理的文件和目录，因此批准任何破坏性操作前请先确认。调试日志可能记录更多细节。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Heimdall，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

🛡️ MCP Heimdall

Advanced Environment Architect & Diagnostic Tool for Model Context Protocol (MCP).

Heimdall helps AI agents understand, verify, and fix their execution environment. It provides detailed insights into system architecture, runtime versions, dependencies, and environment variables, along with actionable correction suggestions.

✨ Features

  • Workspace Janitor: Find large files (>50MB) and temporary directories (dist, build, etc.) for cleanup.
  • Path Inspector: Audit the PATH variable and verify versions of critical dev tools (git, brew, make).
  • Process Explorer: Identify top CPU/Memory consumers and potential orphan Node/Python processes.
  • Docker Sight: Check Docker daemon status, list containers and images.
  • Connectivity Check: Ping essential services (GitHub, NPM, Docker Hub) to verify internet status.
  • Project Doctor: Scan Project for NPM vulnerabilities and outdated packages.
  • Resource Watcher: Monitor CPU load, memory usage, and disk space.
  • Port Manager: List active listening ports and kill processes blocking specific ports.
  • Runtime Inspector: Verify Node.js, Python, Java, and Kotlin versions against project requirements.
  • Dependency Guard: detects missing node_modules or virtual environments.
  • Environment Audit: Compares .env against templates and flags missing keys.
  • Intelligent Advisor: consolidated tool that suggests specific commands to fix environment issues.

🛠️ Tools

ToolDescription
system_infoGet OS and architecture details.
inspect_runtimesCheck Node, Python, Java, and Kotlin versions.
inspect_dockerCheck Docker daemon status and list containers.
check_connectivityTest internet connection to essential dev services.
project_doctorScan for NPM vulnerabilities and outdated packages.
resource_watcherMonitor CPU load, memory and disk usage.
workspace_janitorFind large files and temporary directories for cleanup.
path_inspectorInspect system PATH and critical dev tools versions.
process_explorerIdentify top resource-consuming and orphan processes.
audit_dependenciesDetect missing packages or broken environments.
audit_envVerify .env files against templates.
list_portsList all active listening ports and their processes.
kill_port_processKill the process running on a specific port.
suggest_correctionsThe Core Feature: Runs all checks and returns prioritized solutions.

🚀 Installation

Quick Integration

Run this command to automatically configure Heimdall in your current workspace:

bash
npx @lchampz/mcp-heimdall integrate

This will create a .vscode/mcp.json file with the correct configuration.

For Users (via MCP Registry)

Add to your mcp.json or editor settings:

json
{  "servers": {    "heimdall": {      "command": "node",      "args": ["path/to/mcp-heimdall/build/index.js"]    }  }}

For Developers

  1. Clone the repository
  2. Install dependencies: npm install
  3. Build the project: npm run build
  4. Run in dev mode: npm run dev

📄 License

MIT

来源：README.md，提交 b568d0d

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。