@maiife-ai-pub/mcp-doctor

MCP server health check & auto-fixer — brew doctor for your MCP setup. Detects dead, stale, and misconfigured servers.

Part of the Maiife AI Governance Toolkit.

Install

npm install -g @maiife-ai-pub/mcp-doctor
# or run without installing
npx @maiife-ai-pub/mcp-doctor check

CLI

# Health check all MCP servers
maiife-mcp-doctor check

# Auto-fix detected issues
maiife-mcp-doctor fix

# Watch status continuously (30s interval)
maiife-mcp-doctor status

MCP Server

{
  "mcpServers": {
    "maiife-mcp-doctor": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-doctor", "mcp"]
    }
  }
}

Available tools: mcp_doctor_checkup, mcp_doctor_fix, mcp_doctor_status

Programmatic API

import { runCheckup, watchServers } from "@maiife-ai-pub/mcp-doctor";
import { parseAllMCPConfigs } from "@maiife-ai-pub/mcp-audit";

// One-shot health check
const report = await runCheckup();
console.log(`${report.summary.healthy}/${report.summary.total} servers healthy`);

// Continuous watch — calls onReport every 60 seconds
const servers = parseAllMCPConfigs();
const stop = watchServers(servers, {
  intervalMs: 60_000,
  onReport: (r) => console.log(`${r.summary.healthy}/${r.summary.total} healthy`),
  onStatusChange: (name, prev, curr) => console.warn(`${name}: ${prev} → ${curr}`),
});

// Stop watching
stop();

Health Statuses

| Status | Meaning | |--------|---------| | healthy | Server responds correctly | | degraded | Responds but with errors or high latency | | stale | Config exists but server has not been seen recently | | dead | Unreachable or failing startup |

License

Apache 2.0 — Built by Maiife