Infra Diagnostics

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"