OpenCode MCP Node Requirement¶
Symptom¶
OpenCode boot logs show:
WARN server unavailable key=playwright type=local status=failed
WARN server unavailable key=shopify type=local status=failed
WARN server unavailable key=context7 type=local status=failed
Root cause¶
MCP config in ~/.config/opencode/opencode.json launches several servers via npx -y ...:
- playwright → npx -y @playwright/mcp@latest
- shopify → npx -y shopify-mcp ...
- context7 → npx -y ...
But node/npx is NOT installed system-wide (only bun was added, at ~/.bun/bin).
npx resolves to node, which doesn't exist → the local MCP process can't spawn → status=failed.
youtube works because it points at a real binary (~/.local/bin/youtube-mcp);
memory works because it points at an installed node_module
(~/.config/opencode/node_modules/@modelcontextprotocol/server-memory).
Fix¶
Install node + npm (CachyOS / Arch):
sudo pacman -S --needed nodejs npm
npx now resolves, all three MCPs start.
Alternative (no system node): change npx -y → bunx -y in the MCP commands AND ensure
~/.bun/bin is on the PATH that OpenCode's launcher sees (Hyprland autostart sources fish config,
so bun IS on PATH there). Less robust than installing node.
Status¶
Diagnosed 2026-07-18. Fix (pacman install) pending user apply.