lchampz avatar

Heimdall

lchampz/mcp-heimdall

This is a diagnostic toolkit that gives Claude visibility into your development environment. It exposes tools to check runtime versions (Node, Python, Java, Kotlin), scan for npm vulnerabilities, monitor system resources, audit PATH and environment variables, inspect Docker containers, and kill processes blocking ports. The standout feature is suggest_corrections, which runs all checks at once and returns prioritized fixes for whatever's broken. Reach for this when Claude needs to troubleshoot why a project won't build, verify dependencies are installed, or clean up workspace bloat. It's essentially giving the AI eyes into your shell environment so it can diagnose problems instead of guessing.

tools
14
transport
STDIO
env var
1
last updated
Jan 27, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

system_infoGet OS and architecture details.

Get OS and architecture details.

No parameter schema in public metadata yet.

inspect_runtimesCheck Node, Python, Java, and Kotlin versions.

Check Node, Python, Java, and Kotlin versions.

No parameter schema in public metadata yet.

inspect_dockerCheck Docker daemon status and list containers.

Check Docker daemon status and list containers.

No parameter schema in public metadata yet.

check_connectivityTest internet connection to essential dev services.

Test internet connection to essential dev services.

No parameter schema in public metadata yet.

project_doctorScan for NPM vulnerabilities and outdated packages.

Scan for NPM vulnerabilities and outdated packages.

No parameter schema in public metadata yet.

resource_watcherMonitor CPU load, memory and disk usage.

Monitor CPU load, memory and disk usage.

No parameter schema in public metadata yet.

workspace_janitorFind large files and temporary directories for cleanup.

Find large files and temporary directories for cleanup.

No parameter schema in public metadata yet.

path_inspectorInspect system PATH and critical dev tools versions.

Inspect system PATH and critical dev tools versions.

No parameter schema in public metadata yet.

process_explorerIdentify top resource-consuming and orphan processes.

Identify top resource-consuming and orphan processes.

No parameter schema in public metadata yet.

audit_dependenciesDetect missing packages or broken environments.

Detect missing packages or broken environments.

No parameter schema in public metadata yet.

audit_envVerify `.env` files against templates.

Verify `.env` files against templates.

No parameter schema in public metadata yet.

list_portsList all active listening ports and their processes.

List all active listening ports and their processes.

No parameter schema in public metadata yet.

kill_port_processKill the process running on a specific port.

Kill the process running on a specific port.

No parameter schema in public metadata yet.

suggest_correctionsThe Core Feature: Runs all checks and returns prioritized solutions.

The Core Feature: Runs all checks and returns prioritized solutions.

No parameter schema in public metadata yet.

Sponsors

Configuration

DEBUG

Enable debug logging (true/false)

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


View the full README on GitHub

Details

Repository
github.com/lchampz/mcp-heimdall
Package
@lchampz/mcp-heimdall
Transport
STDIO
Registry
MCP registry, active