I'm excited to share UV-Agent, a new MCP server extension that brings powerful Python environment management to Gemini CLI using uv - the fast Python package manager!

What is UV-Agent?

UV-Agent is a Gemini CLI extension that provides 5 MCP tools for managing Python environments through natural language. It helps you diagnose issues, repair broken environments, and manage dependencies - all without leaving your Gemini CLI session.

✨ Features

5 Powerful Tools

1. check_uv_installation - Check if uv is installed and get version info
2. install_uv - Get platform-specific installation instructions
3. diagnose_environment - Comprehensive health check of your Python environment
4. repair_environment - Automatically fix common environment issues
5. add_dependency - Add dependencies to your Python projects

What It Can Do

• ✅ Detect and diagnose Python environment issues
• ✅ Automatically create virtual environments
• ✅ Sync dependencies from lockfiles
• ✅ Add packages with version constraints
• ✅ Check for dependency conflicts
• ✅ Validate Python version compatibility
• ✅ Cross-platform support (Linux, macOS, Windows)

📦 Installation

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

After installation, restart your Gemini CLI session.

🎯 Usage Examples

Example 1: Diagnose Environment

You: "Check the health of my Python environment"

UV-Agent will analyze your project structure, dependencies, virtual environment, and Python version compatibility.

Example 2: Fix Broken Environment

You: "My Python environment is broken, can you fix it?"

UV-Agent will automatically create missing virtual environments, sync dependencies, and resolve common issues.

Example 3: Add Dependencies

You: "Add requests and pytest as a dev dependency to my project"

UV-Agent will add the packages, update pyproject.toml, and regenerate the lockfile.

🛠️ Technical Details

• Built with: FastMCP 2.14.0
• Python support: 3.10, 3.11, 3.12
• Platforms: Linux, macOS, Windows
• License: MIT
• CI/CD: GitHub Actions with automated testing

📚 Resources

• GitHub Repository: https://github.com/saadmanrafat/uv-mcp
• Documentation: README.md
• Quick Start: GEMINI_CLI_QUICKSTART.md
• Contributing: CONTRIBUTING.md

🤝 Feedback Welcome!

This is my first Gemini CLI extension, and I'd love to hear your feedback! Feel free to:

• Try it out and share your experience
• Report issues or suggest features on GitHub Issues
• Contribute improvements via pull requests

🙏 Acknowledgments

Special thanks to the Gemini CLI team for creating such an extensible platform and excellent documentation!

Install now:

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

Happy coding! 🐍✨