# astral uv mcp

uv-mcp 是一款整合了 Astral 極速 uv Python 套件管理器的 MCP 伺服器，讓 AI 代理能夠透過自然語言診斷、修復及管理 Python 環境。

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

Language: zh-TW

Category: MCP Servers

Updated: 2026-04-06

## 概述

**astral uv mcp**（通常稱為 **uv-mcp**）是一個開源的 **Model Context Protocol (MCP) 伺服器**，它將 [Astral 的 uv](https://docs.astral.sh/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（推薦）
```bash
gemini extensions install https://github.com/saadmanrafat/uv-mcp
```

### 適用於 Claude Desktop / Code
複製儲存庫並將其添加到您的 MCP 設定中（詳情請參閱 [文件](https://saadman.dev/uv-mcp/)）。

需要安裝 **uv**（Astral 的套件管理器）。完整指南可在儲存庫中找到。

## 為何選擇 uv-mcp？

uv 的速度已經是傳統工具如 pip/Poetry 的 10-100 倍。uv-mcp 透過讓 AI 代理直接、安全地存取其強大功能，進一步增強了效能——將「在我的機器上可以運行」轉變為可靠、由代理驅動的可重現性。

## 連結

- GitHub: [saadmanrafat/uv-mcp](https://github.com/saadmanrafat/uv-mcp)
- 說明文件: [saadman.dev/uv-mcp](https://saadman.dev/uv-mcp/)
- uv 官方文件: [docs.astral.sh/uv](https://docs.astral.sh/uv/)

專為現代原生 AI 的 Python 生態系統打造。

## Tags

- mcp
- uv
- python
- 套件管理器
- ai 代理
- 環境管理
- astral
- devops
- claude
- gemini

## Sources

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