# astral uv mcp

uv-mcp es un servidor MCP que envuelve el ultra rápido gestor de paquetes Python uv de Astral, permitiendo a los agentes de IA diagnosticar, reparar y gestionar entornos Python mediante lenguaje natural.

Canonical URL: https://a2a-mcp.org/entry/astral-uv-mcp-es

Language: es

Category: MCP Servers

Updated: 2026-04-06

## 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](https://docs.astral.sh/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)
```bash
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](https://saadman.dev/uv-mcp/)).

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](https://github.com/saadmanrafat/uv-mcp)
- Documentación: [saadman.dev/uv-mcp](https://saadman.dev/uv-mcp/)
- Documentación oficial de uv: [docs.astral.sh/uv](https://docs.astral.sh/uv/)

Desarrollado para el ecosistema Python moderno nativo de IA.

## Tags

- mcp
- uv
- python
- gestor-paquetes
- agente-ia
- gestion-entornos
- astral
- devops
- claude
- gemini

## Sources

- [Project website](https://github.com/saadmanrafat/uv-mcp)