Installation Issues

Solutions to common installation problems with TestSprite MCP Server.

Command Not Found

If you experience issues about npx @testsprite/testsprite-mcp@latest command not found. Please follow the solution below:

1. Check if Node.js and npm are installed

   node --version
   npm --version
   

   If Node.js is not installed, install it first:

   Homebrew (macOS)

   brew install node
   

   Direct Download

   Download from Node.js Official Site

2. Check if npx is available

   npx --version
   

   If npx is not found (should come with npm 5.2+), update npm:

   npm install -g npm@latest
   
3. Try alternative installation methods

   Direct package installation

   npm install -g @testsprite/mcp-server
   testsprite-mcp --version
   

   Use npm exec (npm 7+)

   npm exec @testsprite/testsprite-mcp@latest
   
4. Clear npm cache if packages aren't found

   npm cache clean --force
   

   After cache cleaned, verify npx can find the package

   npx --version
   npx @testsprite/testsprite-mcp@latest --help
   
5. Check npm registry connectivity

   npm ping
   npm config get registry
   

Permission Errors

If you experience issues about Permission denied when installing @testsprite/testsprite-mcp globally. Please follow the solution below:

1. Choose your preferred solution method

   Fix npm permissions (Recommended)

   1. Setup npm permissions

   mkdir ~/.npm-global
   npm config set prefix '~/.npm-global'
   echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc  # or ~/.bashrc for bash
   source ~/.zshrc  # or source ~/.bashrc
   

   2. Install Latest Version

   npm install -g @testsprite/testsprite-mcp@latest
   

   3. Verify Installation

   testsprite-mcp --version
   

   Use npx (Alternative)

   This automatically uses the latest version without permission issues:

   npx @testsprite/testsprite-mcp@latest --version
   

   Install using sudo

   Not recommended due to security risks

   sudo npm install -g @testsprite/testsprite-mcp@latest
   

   Use Node Version Manager (nvm)

   Install nvm for clean permissions:

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
   nvm install node  # Installs latest Node.js with proper permissions
   npm install -g @testsprite/testsprite-mcp@latest
   
2. Troubleshooting permission issues on macOS

   If you still get permission errors, check npm ownership:

   sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
   
3. For fresh npm setup on macOS

   sudo chown -R $(whoami) /usr/local/lib/node_modules
   sudo chown -R $(whoami) /usr/local/bin
   

Node.js Version Compatibility

If you experience issues about TestSprite MCP Server requires Node.js 22+. Please follow the solution below:

Node.js 22 is required for optimal compatibility with TestSprite MCP Server features and dependencies.

1. Check current version

   node --version
   

   If version is below 22, upgrade Node.js

   nvm (Recommended)

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
   source ~/.zshrc  # or source ~/.bashrc
   nvm install 22
   nvm use 22
   nvm alias default 22  
   node --version
   

   After upgrading, verify installation:

   testsprite-mcp --version
   

   Homebrew (macOS)

   brew uninstall node  # Remove old version if needed
   brew install node@22
   brew link node@22 --force
   

   Direct Download

   Visit Node.js Official Site and download Node.js 22 LTS

   Follow the installer instructions for your operating system.

2. Verify npm and npx are working

   npm --version
   npx --version
   
3. Test TestSprite MCP installation

   npx @testsprite/testsprite-mcp@latest --version