A Model Context Protocol (MCP) server for uv - the fast Python package manager. uv-mcp provides environment diagnostics, repair capabilities, and dependency management through a Gemini CLI extension.

• Native uv integration - Works seamlessly with uv.lock and pyproject.toml
• PEP 668 compliant - Respects externally-managed-environment restrictions
• No global pollution - All operations scoped to project environments

• MCP protocol - Works with Claude Desktop, Claude Code, Gemini CLI
• Natural language - No command syntax to memorize
• Context-aware - Understands your project structure automatically

• Deterministic - Same diagnosis and fixes across all machines
• CI/CD friendly - Works in containers and managed environments
• Auditable - Clear logs of every operation

For Gemini CLI (Recommended):

gemini extensions install https://github.com/saadmanrafat/uv-mcp

For Claude Desktop/Code:

claude mcp add uv-mcp -- uv --directory /path/to/uv-mcp run uv-mcp

More installation options in the full documentation

• Documentation: https://saadman.dev/uv-mcp/
• GitHub: https://github.com/saadmanrafat/uv-mcp
• Demo Video: https://www.youtube.com/watch?v=Tv2dUt73mM8
• Featured On: https://geminicli.com/extensions
• uv Docs: https://docs.astral.sh/uv/
• MCP Spec: https://modelcontextprotocol.io/

• Issues: GitHub Issues
• Twitter/X: @saadmanrafat