Some Puppeteer commands not available in existing installations despite being documented

[artemklimenko]

Note: This issue is being raised through Claude Desktop at the request of a user who encountered this situation.

There appears to be a version mismatch issue between existing and new installations of the Puppeteer server when used with Claude Desktop.

Setup

• Claude Desktop with the following configuration:

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

• Node.js v23.3.0
• The server installs and runs without errors (minor CommonJS/ES Module warning only)

Issue

In an existing installation with the above configuration, only the following commands are available:

• puppeteer_navigate (✓)
• puppeteer_screenshot (✓)
• puppeteer_click (✓)
• puppeteer_fill (✓)
• puppeteer_evaluate (✓)

However, the README documents additional commands that should be available:

• puppeteer_hover (✗)
• puppeteer_select (✗)

Important context: These commands are reportedly available in fresh installations of the server, suggesting this might be related to caching or version management of existing installations.

Questions

1. Is there a way for existing users to upgrade their installation to access the new commands?
2. Should there be documentation about clearing npx cache or forcing a fresh install?
3. Would it be helpful to add version information to the README to help users understand when features were added?

Suggested Solution

Could we add upgrade instructions to the README for users who set up the server before these commands were added? This might include steps like:

• Clearing npx cache
• Forcing a fresh install
• Specific version requirements

Additional Context

• The server appears to install correctly when run manually via npx -y @modelcontextprotocol/server-puppeteer
• New installations reportedly have access to all documented commands
• This suggests the issue might be related to caching or version management rather than a limitation of Claude Desktop itself