Resumen

astral uv mcp (comúnmente conocido como uv-mcp) es un servidor de Model Context Protocol (MCP) de código abierto que conecta Astral's uv—el gestor de paquetes y proyectos Python extremadamente rápido basado en Rust—con agentes de IA y herramientas como Claude Desktop, Claude Code y Gemini CLI.

En lugar de que los asistentes de IA simplemente sugieran comandos uv, uv-mcp les permite inspeccionar, diagnosticar y arreglar directamente los entornos de proyectos Python, convirtiendo a la IA en un socio proactivo de DevOps para el desarrollo en Python.

Características

-Los Diagnósticos de Entorno: Analiza automáticamente la estructura del proyecto, entornos virtuales, conflictos de dependencias, archivos de bloqueo (uv.lock) y pyproject.toml. -La Reparación Autónoma: Crea entornos virtuales, inicializa proyectos, sincroniza dependencias y resuelve problemas con una sola llamada a la herramienta. -La Gestión de Dependencias: Añade, elimina o actualiza paquetes (incluyendo dependencias de desarrollo) a través del lenguaje natural—sin necesidad de recordar flags o comandos. -La Integración Nativa con uv: Respeta completamente los flujos de trabajo de uv, los entornos administrados externamente PEP 668, y garantiza configuraciones reproducibles con uv.lock. -La Compatibilidad MCP: Funciona perfectamente con clientes MCP, incluyendo Claude, extensiones de Gemini CLI y otras plataformas de agentes de IA. -La Limitación y Seguridad: Las operaciones están limitadas al proyecto sin contaminación global; ideal para contenedores, CI/CD y entornos administrados. -La Auditable y Determinista: Registros claros y comportamiento consistente entre máquinas para una automatización confiable.

Casos de Uso

-Los Configuración Python Potenciada por IA: Dile a tu agente "Configura un nuevo proyecto de ciencia de datos con pandas y Jupyter"—él maneja uv init, la creación del entorno virtual y la instalación de dependencias. -La Solución de Problemas de Entorno: La IA diagnostica "por qué mi proyecto no funciona" y lo repara automáticamente. -La Resolución de Dependencias: Resuelve conflictos o actualiza archivos de bloqueo sin intervención manual. -Los Flujos de Trabajo Multiagente: Se integra en orquestaciones MCP/agentes de IA más grandes para la automatización del desarrollo Python de pila completa. -Los CI/CD y Construcciones Reproducibles: Garantiza entornos consistentes en pipelines automatizados.

Instalación y Inicio Rápido

Para Gemini CLI (recomendado)

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

Para Claude Desktop / Code

Clona el repositorio y añádelo a tu configuración MCP (detalles en la documentación).

Requiere que uv (el gestor de paquetes de Astral) esté instalado. Guías completas disponibles en el repositorio.

¿Por qué uv-mcp?

uv ya es de 10 a 100 veces más rápido que herramientas tradicionales como pip/Poetry. uv-mcp lo potencia aún más dando a los agentes de IA acceso directo y seguro a su capacidad—convirtiendo "funciona en mi máquina" en una reproducibilidad confiable y dirigida por agentes.

Enlaces

GitHub: saadmanrafat/uv-mcp
Documentación: saadman.dev/uv-mcp
Documentación oficial de uv: docs.astral.sh/uv

Desarrollado para el ecosistema Python moderno nativo de IA.