Skip to content

uv-mcp

The full uv toolchain for AI coding agents. Projects, dependencies, Python versions, virtual environments and tools, as safe, typed MCP tools.
Terminal window
claude mcp add --scope user --transport stdio uv -- uvx uv-mcp-server@latest

Or codex mcp add uv -- uvx uv-mcp-server@latest, or gemini extensions install https://github.com/saadmanrafat/uv-mcp. The only prerequisite is uv. All clients.

Every uv command and option51 tools named after the CLI (uv_add, uv_sync, uv_run, uv_python_install, uv_tool_run, uv_pip_compile…), validated extra_args for every other option, uv_help to discover any option, and uv_command for everything else.
Structured resultssuccess, exit_code, stdout, stderr and an actionable hint on failure; parsed package, Python and tool lists.
Diagnose and repairuv_diagnose checks interpreter, lockfile, .venv and package consistency; uv_repair fixes what it finds.
Secure by designNo shell, argument-injection guards, secret redaction, honest MCP annotations, read-only mode, path confinement, dry-run publishing.
Runs in the right placeAlways your project’s environment, never the server’s own; uv_info shows exactly where.
Context-friendlyCompact schemas, toolsets to load only what you need, bounded output.

Claude Code, Codex CLI, Gemini CLI (as an extension), Claude Desktop, Cursor, VS Code, OpenCode, and any client that speaks MCP over stdio.