Skip to main content
Glama
turlockmike

DevOps Dashboard MCP Server

by turlockmike

DevOps Dashboard MCP Server

Monitor and manage Linux infrastructure through your AI assistant. Built on the Model Context Protocol (MCP), this server gives Claude (or any MCP-compatible client) full visibility into your systems — services, logs, resources, containers, and more.

Tools

Tool

Description

service_status

Check systemd service status (active, failed, enabled state, PID, memory)

service_logs

Fetch journalctl logs with time range, priority, and grep filtering

process_list

List processes sorted by CPU/memory with optional name filtering

disk_usage

Disk space and inode usage by mount point

memory_info

RAM and swap usage, with optional /proc/meminfo details

port_scan

List listening TCP/UDP ports with associated processes

cron_list

List cron jobs for any/all users plus system cron files

nginx_config

Read, validate, and inspect nginx configuration and sites

docker_status

Container, image, volume, network, and resource usage overview

system_health

Aggregate health check with thresholds and warnings

Related MCP server: Docker MCP Server

Quick Start

Install from npm

npm install -g @devops-dashboard/mcp-server

Or run directly with npx

npx @devops-dashboard/mcp-server

Configure in Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "devops-dashboard": {
      "command": "npx",
      "args": ["@devops-dashboard/mcp-server"]
    }
  }
}

Configure in Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "devops-dashboard": {
      "command": "npx",
      "args": ["@devops-dashboard/mcp-server"]
    }
  }
}

Development

git clone https://github.com/turlockmike/devops-dashboard-mcp.git
cd devops-dashboard-mcp
npm install
npm run dev          # Start with tsx (hot reload)
npm run build        # Compile TypeScript
npm test             # Run test suite

Tool Details

service_status

Check whether a systemd service is running, its enabled/disabled state, PID, and recent status output.

Parameters:
  service (string, required) — Service name (e.g. "nginx", "sshd")
  user (boolean, optional) — Query user-level services (--user)

service_logs

Fetch recent journal logs with powerful filtering. Supports time ranges, priority levels, and text search.

Parameters:
  service (string, required) — Service name
  lines (number, 1-1000, default 50) — Number of log lines
  since (string, optional) — Time filter ("1h ago", "today", "2024-01-15")
  priority (string, optional) — Minimum level (emerg/alert/crit/err/warning/notice/info/debug)
  grep (string, optional) — Filter by pattern
  user (boolean, optional) — Query user-level service logs

process_list

List running processes with resource usage. Sort by CPU, memory, PID, or elapsed time.

Parameters:
  sort (string, default "cpu") — Sort field: cpu, mem, pid, time
  limit (number, 1-200, default 20) — Number of processes to show
  filter (string, optional) — Filter by process name (case-insensitive)

disk_usage

Show disk space and inode usage. Excludes virtual filesystems for clean output.

Parameters:
  path (string, optional) — Specific mount point or path
  human (boolean, default true) — Human-readable sizes

memory_info

RAM, swap, and system load. Detailed mode adds buffer/cache breakdown from /proc/meminfo.

Parameters:
  detailed (boolean, default false) — Include /proc/meminfo details

port_scan

List all listening network ports with their owning processes. Uses ss with netstat fallback.

Parameters:
  port (number, 1-65535, optional) — Check a specific port
  protocol (string, default "all") — Filter: tcp, udp, all

cron_list

Enumerate cron jobs across users and system directories.

Parameters:
  user (string, optional) — Specific user to query
  all (boolean, default false) — List jobs for ALL users
  include_system (boolean, default true) — Include /etc/crontab and /etc/cron.d/

nginx_config

Read and validate nginx configuration.

Parameters:
  action (string, required) — show, test, list_sites, or full_config
  site (string, optional) — Specific site config to read (with "show" action)

docker_status

Docker environment overview. Gracefully handles missing Docker or stopped daemon.

Parameters:
  action (string, default "overview") — overview, containers, images, stats, networks, volumes
  filter (string, optional) — Filter by container/image name

system_health

Aggregate health check that inspects memory, disk, load, failed services, and network listeners. Returns HEALTHY or ISSUES DETECTED with specific warnings.

Parameters:
  verbose (boolean, default false) — Include full details per subsystem

Requirements

  • Node.js >= 18

  • Linux (uses systemd, journalctl, ss, df, free, ps, etc.)

  • Optional: Docker, nginx (tools degrade gracefully if not present)

Architecture

src/
├── index.ts          # MCP server entry point, tool registration
├── tools/
│   ├── service.ts    # systemd service status + logs
│   ├── system.ts     # processes, disk, memory, ports, health
│   ├── cron.ts       # cron job listing
│   ├── nginx.ts      # nginx config management
│   └── docker.ts     # Docker container/image tools
└── utils/
    └── exec.ts       # Safe command execution (execFile, no shell)

All system commands run through safeExec() which uses execFile (not exec) to prevent shell injection. Commands have configurable timeouts and output size limits.

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/turlockmike/devops-dashboard-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server