astral uv mcp

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.

Links

• GitHub: saadmanrafat/uv-mcp
• Documentação: saadman.dev/uv-mcp
• Documentação Oficial do uv: docs.astral.sh/uv

Criado para o ecossistema Python moderno nativo para IA.