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

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"