Skip to content

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
(youtube + memory MCPs work fine.)

Root cause

MCP config in ~/.config/opencode/opencode.json launches several servers via npx -y ...: - playwrightnpx -y @playwright/mcp@latest - shopifynpx -y shopify-mcp ... - context7npx -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
Then restart OpenCode. npx now resolves, all three MCPs start.

Alternative (no system node): change npx -ybunx -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.