MCP Health Monitor MCP Server

Name: MCP Health Monitor MCP Server
Author: io.github.oaslananka

io.github.oaslananka/health-monitor-mcp

Repository Registry

What is the MCP Health Monitor MCP server?

Monitor MCP, CI, and HTTP targets with health history, TLS expiry, assertions, and diagnostics

How to install MCP Health Monitor

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

HEALTH_MONITOR_DB
Custom path for the SQLite database
HEALTH_MONITOR_AUTO_CHECK
Set to '1' to enable background scheduled checks
HEALTH_MONITOR_RETENTION_DAYS
Number of days to retain health check history
HEALTH_MONITOR_MAX_CONCURRENCY
Maximum concurrent scheduled and interactive server checks
GITHUB_TOKEN
secret
Optional GitHub token with Actions read access for private repositories and higher API rate limits
GITLAB_TOKEN
secret
Optional GitLab token with read access to private projects, pipelines, jobs, and traces
HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST
Comma-separated self-hosted GitLab HTTPS origins allowed for monitoring
HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST
Comma-separated private HTTP(S) origins allowed only in the full runtime profile

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "health-monitor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ],
      "env": {
        "HEALTH_MONITOR_DB": "<YOUR_HEALTH_MONITOR_DB>",
        "HEALTH_MONITOR_AUTO_CHECK": "<YOUR_HEALTH_MONITOR_AUTO_CHECK>",
        "HEALTH_MONITOR_RETENTION_DAYS": "<YOUR_HEALTH_MONITOR_RETENTION_DAYS>",
        "HEALTH_MONITOR_MAX_CONCURRENCY": "<YOUR_HEALTH_MONITOR_MAX_CONCURRENCY>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST": "<YOUR_HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST>",
        "HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST": "<YOUR_HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "health-monitor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ],
      "env": {
        "HEALTH_MONITOR_DB": "<YOUR_HEALTH_MONITOR_DB>",
        "HEALTH_MONITOR_AUTO_CHECK": "<YOUR_HEALTH_MONITOR_AUTO_CHECK>",
        "HEALTH_MONITOR_RETENTION_DAYS": "<YOUR_HEALTH_MONITOR_RETENTION_DAYS>",
        "HEALTH_MONITOR_MAX_CONCURRENCY": "<YOUR_HEALTH_MONITOR_MAX_CONCURRENCY>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST": "<YOUR_HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST>",
        "HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST": "<YOUR_HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "health-monitor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ],
      "env": {
        "HEALTH_MONITOR_DB": "<YOUR_HEALTH_MONITOR_DB>",
        "HEALTH_MONITOR_AUTO_CHECK": "<YOUR_HEALTH_MONITOR_AUTO_CHECK>",
        "HEALTH_MONITOR_RETENTION_DAYS": "<YOUR_HEALTH_MONITOR_RETENTION_DAYS>",
        "HEALTH_MONITOR_MAX_CONCURRENCY": "<YOUR_HEALTH_MONITOR_MAX_CONCURRENCY>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST": "<YOUR_HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST>",
        "HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST": "<YOUR_HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "health-monitor-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "health-monitor-mcp"
      ],
      "env": {
        "HEALTH_MONITOR_DB": "<YOUR_HEALTH_MONITOR_DB>",
        "HEALTH_MONITOR_AUTO_CHECK": "<YOUR_HEALTH_MONITOR_AUTO_CHECK>",
        "HEALTH_MONITOR_RETENTION_DAYS": "<YOUR_HEALTH_MONITOR_RETENTION_DAYS>",
        "HEALTH_MONITOR_MAX_CONCURRENCY": "<YOUR_HEALTH_MONITOR_MAX_CONCURRENCY>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST": "<YOUR_HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST>",
        "HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST": "<YOUR_HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST>"
      }
    }
  }
}

Claude Code

claude mcp add health-monitor-mcp --env HEALTH_MONITOR_DB=<YOUR_HEALTH_MONITOR_DB> --env HEALTH_MONITOR_AUTO_CHECK=<YOUR_HEALTH_MONITOR_AUTO_CHECK> --env HEALTH_MONITOR_RETENTION_DAYS=<YOUR_HEALTH_MONITOR_RETENTION_DAYS> --env HEALTH_MONITOR_MAX_CONCURRENCY=<YOUR_HEALTH_MONITOR_MAX_CONCURRENCY> --env GITHUB_TOKEN=<YOUR_GITHUB_TOKEN> --env GITLAB_TOKEN=<YOUR_GITLAB_TOKEN> --env HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST=<YOUR_HEALTH_MONITOR_GITLAB_BASE_URL_ALLOWLIST> --env HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST=<YOUR_HEALTH_MONITOR_HTTP_TARGET_ALLOWLIST> -- npx -y health-monitor-mcp