Skip to content

fix(mcp): use global binary instead of npx @latest to fix Windows MCP connection failure#52

Open
millenappleacc-web wants to merge 1 commit into
jordanrendric:mainfrom
millenappleacc-web:fix/mcp-npx-windows
Open

fix(mcp): use global binary instead of npx @latest to fix Windows MCP connection failure#52
millenappleacc-web wants to merge 1 commit into
jordanrendric:mainfrom
millenappleacc-web:fix/mcp-npx-windows

Conversation

@millenappleacc-web

Copy link
Copy Markdown

What changed

Changed .mcp.json to invoke claude-video-vision directly instead of via npx -y claude-video-vision@latest.

Why

On Windows, npx -y claude-video-vision@latest fails with:

Unknown command: "claude-video-vision@latest"
To see a list of supported npm commands, run:
  npm help

This causes the MCP server to report ✘ Failed to connect in claude mcp list, making all video_* tools unavailable even after a fresh Claude Code session.

The workaround is to install the package globally (npm install -g claude-video-vision) and invoke the binary directly — which connects successfully.

Fix

{
  "claude-video-vision": {
    "command": "claude-video-vision"
  }
}

This works on Windows (confirmed) and should work on macOS/Linux as well since npx resolution of a bare binary name is reliable once installed.

Reviewer notes

  • A longer-term fix might be to detect the OS and use a platform-appropriate invocation, or document the global install as a Windows prerequisite.
  • Alternatively, the README's Quick Start could mention npm install -g claude-video-vision as a Windows-specific step.

🤖 Generated with Claude Code

…nection failure

`npx -y claude-video-vision@latest` fails on Windows with "Unknown command"
because some npm versions don't handle the package@version syntax with -y
correctly. Using the bare `claude-video-vision` command works after a global
install and avoids the npx resolution issue entirely.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants