whyreach

● Active

io.github.SandstromPL/whyreach

Read-only Docker network diagnosis: why one container can't reach another, with evidence.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "whyreach": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network",
        "host",
        "--pid",
        "host",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "ghcr.io/sandstrompl/whyreach:0.1.0",
        "mcp",
        "serve"
      ]
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add whyreach -- docker run -i --rm --network host --pid host -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/sandstrompl/whyreach:0.1.0 mcp serve
OpenAI Codex CLI
codex mcp add whyreach -- docker run -i --rm --network host --pid host -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/sandstrompl/whyreach:0.1.0 mcp serve
VS Code
code --add-mcp '{"name":"whyreach","type":"stdio","command":"docker","args":["run","-i","--rm","--network","host","--pid","host","-v","/var/run/docker.sock:/var/run/docker.sock","ghcr.io/sandstrompl/whyreach:0.1.0","mcp","serve"]}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Cloud & DevOps
Version
0.1.0
Registry
active
Published
11/14/2026

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 14, 2026
License
Apache-2.0

Goai-agentsclaude-codeclidevtoolsdockerdocker-composedocker-networkinggolanglinuxmcpmcp-servermodel-context-protocolnetwork-diagnosticsnetworkingtroubleshooting

From the README

whyreach What is it? A tool that tells you why one Docker container can't connect to another container or to the host. It shows the proof and the fix, and it changes nothing. You can run it yourself or let your AI coding agent run it. Why does it exist? Errors like Connection refused or a timeout don't say what's wrong. The cause could be a wrong address or port, a service that only listens to itself, containers on different networks, or a service that isn't ready yet. whyreach finds the real one. Who is it for? Developers who run several services with Docker Compose on Linux, often together with an AI coding agent such as Claude Code, Codex or Cursor. Docker Desktop on macOS and Windows comes later. Why was it needed? Finding the cause by hand takes many commands, and you need to know Docker networking well. Small images often don't have the tools to check from inside. AI agents doing the same take many steps and may run commands that change things. Why use it? • One step: one command gives you the cause, the proof and the fix. • Safe: it only looks.…

Read the full README on GitHub →

Alternatives to whyreach

Best Cloud & DevOps servers →

The most-starred Cloud & DevOps servers in the index, with their live-check result.

ServerStarsLast pushLive check
Netdata81,426Nov 2026Needs sign-in
kubeshark MCP12,146Nov 2026Local / not checked
OneUptime7,820Nov 2026Working
cloudflare.mcp MCP4,473Oct 2026Working
Radar Kubernetes MCP Server4,129Nov 2026Local / not checked

whyreach: questions people ask

Is whyreach a remote or a local MCP server?
According to its entry in the official MCP registry, whyreach ships as a local package (Docker) that your client starts on your machine.
Is whyreach still maintained?
Active: the repository's last commit 5 days ago. Last push Nov 14, 2026, 0 GitHub stars, Apache-2.0 licence. Read from GitHub on Nov 18, 2026.
How do I add whyreach to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Cloud & DevOps →

Add the badge to your site

Show visitors that whyreach is listed here — it’s also the link we check for a free listing.

whyreach — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sandstrompl-whyreach?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="whyreach — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![whyreach — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sandstrompl-whyreach?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.