概述

astral uv mcp（通常简称为 uv-mcp）是一个开源的 Model Context Protocol (MCP) 服务器，它将 Astral 的 uv——基于 Rust 的极速 Python 包和项目管理器——与 AI 代理及工具（如 Claude Desktop、Claude Code 和 Gemini CLI）连接起来。

uv-mcp 不仅仅是让 AI 助手建议 uv 命令，而是允许它们直接检查、诊断和修复 Python 项目环境，使 AI 成为 Python 开发中主动的 DevOps 伙伴。

功能特性

-T环境诊断：自动分析项目结构、虚拟环境、依赖冲突、锁文件 (uv.lock) 和 pyproject.toml。 -T自我修复：通过单一工具调用即可创建虚拟环境、初始化项目、同步依赖并解决问题。 -T依赖管理：通过自然语言添加、移除或更新包（包括开发依赖）——无需记忆参数或命令。 -T原生 uv 集成：完全遵循 uv 工作流、PEP 668 外部管理环境，并通过 uv.lock 确保可复现的设置。 -TMCP 兼容性：与包括 Claude、Gemini CLI 扩展和其他 AI 代理平台在内的 MCP 客户端无缝协作。 -T作用域限定且安全：操作限定在项目范围内，不会产生全局污染；适用于容器、CI/CD 和托管环境。 -T可审计且确定性：清晰的日志和跨机器一致的行为，确保可靠的自动化。

使用场景

-TAI 驱动的 Python 环境设置：告诉您的代理“用 pandas 和 Jupyter 建立一个新数据科学项目”——它将处理 uv init、虚拟环境创建和依赖安装。 -T环境故障排除：AI 诊断“为什么我的项目无法运行”并自动修复。 -T依赖解析：无需手动干预即可解决冲突或更新锁文件。 -T多代理工作流：集成到更大的 MCP/AI 代理编排中，实现全栈 Python 开发自动化。 -TCI/CD 与可复现构建：在自动化流水线中确保环境一致性。

安装与快速开始

对于 Gemini CLI（推荐）

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

对于 Claude Desktop / Code

克隆仓库并添加到您的 MCP 配置中（详情见文档）。

需要安装 uv（Astral 的包管理器）。完整指南可在仓库中找到。

为什么选择 uv-mcp？

uv 已经比 pip/Poetry 等传统工具快 10-100 倍。uv-mcp 通过赋予 AI 代理直接、安全的访问权限来进一步释放其潜力——将“它在我机器上能运行”转变为可靠、由代理驱动的可复现性。

链接

GitHub: saadmanrafat/uv-mcp
文档: saadman.dev/uv-mcp
uv 官方文档: docs.astral.sh/uv

专为现代 AI 原生的 Python 生态系统打造。

概述