infra-diagnostics-mcp

infra-diagnostics-mcp

An MCP server exposing infrastructure diagnostic tools (port checks, DNS lookups, log parsing, system health, SSL cert inspection) over stdio.

Setup

cd /Users/kuuashwa/Desktop/Workspace/MyProjects/infra-diagnostics-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run Standalone (for testing)

python server.py

The server reads JSON-RPC from stdin and writes to stdout. Not useful to run manually — it's meant to be launched by an MCP client.

Add to opencode

Edit ~/.config/opencode/config.json:

{
  "mcpServers": {
    "infra-diagnostics": {
      "type": "stdio",
      "command": "/Users/kuuashwa/Desktop/Workspace/MyProjects/infra-diagnostics-mcp/.venv/bin/python",
      "args": ["server.py"],
      "cwd": "/Users/kuuashwa/Desktop/Workspace/MyProjects/infra-diagnostics-mcp"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | check_port | TCP connectivity test with latency measurement | | dns_lookup | DNS record resolution (A, AAAA, MX, CNAME, TXT, NS) | | parse_logs | Extract errors/warnings from log text | | system_health | CPU, memory, disk, load average, open FDs | | ssl_cert_check | SSL certificate expiry and details |

Examples

Once connected via opencode, you can ask:

• "Check if port 5432 is reachable on db.internal.example.com"
• "Look up MX records for example.com"
• "Parse these logs for errors: [paste logs]"
• "Show current system health"
• "Check the SSL cert on github.com"