Can't work locally. Always crashes.

[albert-a]

npx -y zig-mcp@latest
Error: terminated

It crushes exactly in 1m13s after start.
I tried to install it, but the result is the same:

npm install -g zig-mcp@latest
zig-mcp
Error: terminated

According to strace, it always tries to fetch something from ziglang.org even when not asked to, even with --doc-source local, fails and exits.

Ubuntu 24.04.4
node: v24.13.1 installed with nvm --lts
Zig 0.15.2 installed with zvm.

[Afirium]

Hey @albert-a, maybe this is a DNS problem?
Can you please send me the outputs of this:
curl -I https://ziglang.org/documentation/master/std/sources.tar

Check also that local zig docs works:
zig std --no-open-browser --port 0

Try this workaround and let me know if it works:

mkdir -p ~/.cache/zig-mcp/master
printf '[]\n' > ~/.cache/zig-mcp/master/builtin-functions.json
npx -y zig-mcp@latest --doc-source local

[albert-a]

I can confirm that everything works today, although the yesterday I was only able to launch it throug a http proxy.
I think some address was blocked by my ISP or government, because without the proxy zig-mcp kept throwing the error.

curl -I https://ziglang.org/documentation/master/std/sources.tar
HTTP/1.1 200 OK
Server: nginx/1.18.0
Date: Wed, 25 Feb 2026 17:35:19 GMT
Content-Type: application/octet-stream
Last-Modified: Wed, 25 Feb 2026 13:27:54 GMT
Connection: keep-alive
ETag: W/"699ef8da-2e003a"

your command works, zig docs works and your workaround also works currently.

My intention was to work locally and I was wandering why it connects to the site at all.
May I ask, is it possible to work completely locally? I just don't want to be distracted from work by connection issues.

[Afirium]

Thanks for the update! Yeah, you've found an interesting bug that shows up when the connection to zigwasm.org fails. After that, any subsequent MCP starts with --doc-source local still try to connect to zigwasm.org. I'll publish a version with a fix later this week

[albert-a]

Great, thanks for your support. I'm waiting for a fix.