astral uv mcp

概要

astral uv mcp（一般に uv-mcp として知られる）は、オープンソースの Model Context Protocol (MCP) サーバー であり、極めて高速な Rust ベースの Python パッケージ・プロジェクトマネージャーである Astral's 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 用（推奨）

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 エージェントにそのパワーへの直接的な安全なアクセスを提供することで、uv をさらに強化し、「私のマシンでは動く」という状況を、信頼できるエージェント駆動の再現性へと変えます。

リンク

• GitHub: saadmanrafat/uv-mcp
• ドキュメント: saadman.dev/uv-mcp
• uv 公式ドキュメント: docs.astral.sh/uv

モダンなAIネイティブなPythonエコシステムのために構築されました。