# infra-diagnostics-mcp

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

## Setup

```bash
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)

```bash
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`:

```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"