astral uv mcp

概述

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 合作夥伴。

功能特色

/ 環境診斷：自動分析專案結構、虛擬環境、相依性衝突、鎖定檔 (uv.lock) 以及 pyproject.toml。 / 自我修復：透過單一工具呼叫，即可建立虛擬環境、初始化專案、同步相依性並解決問題。 / 相依性管理：透過自然語言添加、移除或更新套件（包含開發相依性）——無需記憶參數或指令。 / 原生 uv 整合：完全遵循 uv 工作流程、PEP 668 外部管理環境，並確保透過 uv.lock 實現可重現的設定。 / MCP 相容性：與 MCP 客戶端（包括 Claude、Gemini CLI 擴展及其他 AI 代理平台）無縫協作。 / 限定範圍與安全：操作限定於專案範圍，無全域污染；適用於容器、CI/CD 及受管環境。 / 可稽核且具確定性：清晰的日誌記錄，跨機器一致的行為，確保自動化可靠。

使用案例

/ AI 驅動的 Python 設定：告訴您的代理「建立一個新的資料科學專案，使用 pandas 和 Jupyter」——它會處理 uv init、虛擬環境建立以及相依性安裝。 / 環境疑難排解：AI 診斷「為何我的專案無法執行」並自動修復。 / 相依性解析：解決衝突或更新鎖定檔，無需手動介入。 / 多代理工作流程：整合到更大的 MCP/AI 代理協調中，實現全堆疊 Python 開發自動化。 / CI/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 生態系統打造。