Troubleshooting
Fix "uvx: command not found" for Python MCP servers
Python MCP servers usually start with uvx, which comes with the uv package manager. The error means uv is not installed or the app cannot find it. Install uv, then use the full path to uvx in the config and restart the app.
Why it happens
- uv is not installed.
- uv is installed in a folder that your desktop app does not search.
How to fix it
- 1
Install uv
Follow the install guide on docs.astral.sh/uv. On macOS with Homebrew you can run
brew install uv. Then check it withuvx --version. - 2
Use the full path to uvx
Run
which uvx(orwhere uvxon Windows) and use that path as the command, for example"command": "/Users/you/.local/bin/uvx". - 3
Restart the app
Quit the app fully and reopen it.
Still stuck? Every server page on this site shows the exact config for each app. Find your server.