# astral uv mcp

uv-mcpは、Astralの超高速uvパッケージマネージャーをラップしたMCPサーバーであり、AIエージェントが自然言語を通じてPython環境の診断、修復、管理を可能にします。

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

Language: ja

Category: MCP Servers

Updated: 2026-04-06

## 概要

**astral uv mcp**（一般に **uv-mcp** として知られる）は、オープンソースの **Model Context Protocol (MCP) サーバー** であり、極めて高速な Rust ベースの Python パッケージ・プロジェクトマネージャーである [Astral's uv](https://docs.astral.sh/uv/) と、Claude Desktop、Claude Code、Gemini CLI などの AI エージェントやツールを橋渡しします。

AI アシスタントが単に `uv` コマンドを提案するだけでなく、uv-mcp によって、AI は Python プロジェクト環境を直接検査、診断、修正できるようになり、AI を Python 開発の積極的な DevOps パートナーに変えます。

## 機能



- **環境診断**: プロジェクト構造、仮想環境、依存関係の競合、ロックファイル (`uv.lock`)、`pyproject.toml` を自動的に分析します。
- **自己修復**: 仮想環境の作成、プロジェクトの初期化、依存関係の同期、問題の解決を単一のツール呼び出しで行います。
- **依存関係管理**: 自然言語でパッケージ（開発依存関係を含む）の追加、削除、更新が可能です。フラグやコマンドを覚える必要はありません。
- **ネイティブ uv 連携**: `uv` のワークフロー、PEP 668 の外部管理環境を完全に尊重し、`uv.lock` による再現可能なセットアップを保証します。
- **MCP 互換性**: Claude、Gemini CLI 拡張機能、その他の AI エージェントプラットフォームを含む MCP クライアントとシームレスに連携します。
- **スコープ化・安全**: 操作はプロジェクトスコープで行われ、グローバルな汚染がありません。コンテナ、CI/CD、管理環境に最適です。
- **監査可能・決定論的**: 明確なログとマシン間で一貫した動作により、信頼性の高い自動化を実現します。

## ユースケース

- **AI 駆動の Python セットアップ**: 「pandas と Jupyter を使った新しいデータサイエンスプロジェクトをセットアップして」とエージェントに指示するだけで、`uv init`、venv 作成、依存関係のインストールを処理します。
- **環境トラブルシューティング**: 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 エージェントにそのパワーへの直接的な安全なアクセスを提供することで、uv をさらに強化し、「私のマシンでは動く」という状況を、信頼できるエージェント駆動の再現性へと変えます。

## リンク

- 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)
