Übersicht

astral uv mcp (häufig als uv-mcp bezeichnet) ist ein quelloffener Model Context Protocol (MCP) Server, der Astral's uv – den extrem schnellen, in Rust geschriebenen Python-Paket- und Projektmanager – mit KI-Agenten und Tools wie Claude Desktop, Claude Code und Gemini CLI verbindet.

Anstatt dass KI-Assistenten lediglich uv-Befehle vorschlagen, ermöglicht uv-mcp ihnen, Python-Projektumgebungen direkt zu inspizieren, zu diagnostizieren und zu reparieren, wodurch KI zu einem proaktiven DevOps-Partner für die Python-Entwicklung wird.

Funktionen

Umgebungsdiagnose: Analysiert automatisch die Projektstruktur, virtuelle Umgebungen, Abhängigkeitskonflikte, Lockfiles (uv.lock) und pyproject.toml.
Selbstheilende Reparaturen: Erstellt virtuelle Umgebungen, initialisiert Projekte, synchronisiert Abhängigkeiten und löst Probleme mit einem einzigen Tool-Aufruf.
Abhängigkeitsverwaltung: Pakete hinzufügen, entfernen oder aktualisieren (einschließlich Entwicklungsabhängigkeiten) über natürliche Sprache – keine Notwendigkeit, Flags oder Befehle auswendig zu lernen.
Native uv-Integration: Respektiert vollständig uv-Workflows, PEP 668 extern verwaltete Umgebungen und stellt mit uv.lock reproduzierbare Setups sicher.
MCP-Kompatibilität: Funktioniert nahtlos mit MCP-Clients wie Claude, Gemini CLI-Erweiterungen und anderen KI-Agenten-Plattformen.
Bereichsbezogen & Sicher: Operationen sind projektbezogen ohne globale Beeinträchtigung; ideal für Container, CI/CD und verwaltete Umgebungen.
Nachvollziehbar & Deterministisch: Klare Protokolle und konsistentes Verhalten über verschiedene Maschinen hinweg für zuverlässige Automatisierung.

Anwendungsfälle

KI-gestütztes Python-Setup: Sagen Sie Ihrem Agenten "Richte ein neues Data-Science-Projekt mit pandas und Jupyter ein" – er übernimmt uv init, Venv-Erstellung und Abhängigkeitsinstallation.
Umgebungsproblembehebung: KI diagnostiziert "warum mein Projekt nicht läuft" und repariert es automatisch.
Abhängigkeitsauflösung: Lösen Sie Konflikte oder aktualisieren Sie Lockfiles ohne manuelles Eingreifen.
Multi-Agenten-Workflows: Integration in größere MCP-/KI-Agenten-Orchestrierungen für Full-Stack-Python-Entwicklungsautomatisierung.
CI/CD & Reproduzierbare Builds: Stellen Sie konsistente Umgebungen in automatisierten Pipelines sicher.

Installation & Schnellstart

Für Gemini CLI (empfohlen)

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

Für Claude Desktop / Code

Klonen Sie das Repository und fügen Sie es Ihrer MCP-Konfiguration hinzu (Details in der Dokumentation).

Erfordert die Installation von uv (Astral's Paketmanager). Vollständige Anleitungen sind im Repository verfügbar.

Warum uv-mcp?

uv ist bereits 10-100x schneller als traditionelle Tools wie pip/Poetry. uv-mcp verstärkt dies, indem es KI-Agenten direkten, sicheren Zugang zu seiner Leistung gibt – und verwandelt "es funktioniert auf meiner Maschine" in zuverlässige, agentengesteuerte Reproduzierbarkeit.

astral uv mcp