Visão Geral

astral uv mcp (comumente conhecido como uv-mcp) é um servidor Model Context Protocol (MCP) de código aberto que conecta o Astral's uv—o gerenciador de pacotes e projetos Python extremamente rápido baseado em Rust—com agentes de IA e ferramentas como Claude Desktop, Claude Code e Gemini CLI.

Em vez de os assistentes de IA apenas sugerirem comandos uv, o uv-mcp permite que eles inspecionem, diagnosticem e corrijam diretamente os ambientes de projeto Python, tornando a IA um parceiro DevOps proativo para o desenvolvimento Python.

Funcionalidades

Diagnóstico de Ambiente: Analisa automaticamente a estrutura do projeto, ambientes virtuais, conflitos de dependências, arquivos de bloqueio (uv.lock) e pyproject.toml.

Reparos de Autocorreção: Cria ambientes virtuais, inicializa projetos, sincroniza dependências e resolve problemas com uma única chamada de ferramenta.
Gestão de Dependências: Adicione, remova ou atualize pacotes (incluindo dependências de desenvolvimento) via linguagem natural—sem necessidade de lembrar flags ou comandos.
Integração Nativa do uv: Respeita totalmente os fluxos de trabalho do uv, ambientes gerenciados externamente pela PEP 668 e garante configurações reproduzíveis com uv.lock.
Compatibilidade MCP: Funciona perfeitamente com clientes MCP, incluindo Claude, extensões do Gemini CLI e outras plataformas de agentes de IA.
Escopo Seguro: As operações são limitadas ao projeto, sem poluição global; ideal para containers, CI/CD e ambientes gerenciados.
Auditável & Determinístico: Logs claros e comportamento consistente entre máquinas para automação confiável.

Casos de Uso

— Configuração Python com IA: Diga ao seu agente "Configure um novo projeto de ciência de dados com pandas e Jupyter"—ele cuida do uv init, criação do venv e instalação de dependências.

Solução de Problemas de Ambiente: IA diagnostica "por que meu projeto não está funcionando" e o repara automaticamente.

Resolução de Dependências: Resolva conflitos ou atualize arquivos de bloqueio sem intervenção manual.
Fluxos de Trabalho Multiagente: Integre em orquestrações maiores de MCP/agentes de IA para automação de desenvolvimento Python full-stack. — CI/CD & Builds Reproduzíveis: Garanta ambientes consistentes em pipelines automatizados.

Instalação & Início Rápido

Para Gemini CLI (recomendado)

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

Para Claude Desktop / Code

Clone o repositório e adicione à sua configuração MCP (detalhes na documentação).

Requer que o uv (gerenciador de pacotes da Astral) esteja instalado. Guias completos disponíveis no repositório.

Por que uv-mcp?

O uv já é 10 a 100 vezes mais rápido que ferramentas tradicionais como pip/Poetry. O uv-mcp o turbina dando aos agentes de IA acesso direto e seguro ao seu poder—transformando "funciona na minha máquina" em uma reprodutibilidade confiável e orientada por agentes.

astral uv mcp