https://github.com/saadmanrafat/uv-mcp

Bridge modern, reproducible Python environments with MCP agents. Diagnose, self-heal, and manage uv workflows
https://github.com/saadmanrafat/uv-mcp

gemini-cli-extensions mcp uv

Last synced: 4 months ago
JSON representation

Bridge modern, reproducible Python environments with MCP agents. Diagnose, self-heal, and manage uv workflows

• Host: GitHub
• URL: https://github.com/saadmanrafat/uv-mcp
• Owner: saadmanrafat
• License: apache-2.0
• Created: 2025-12-12T23:50:06.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-12-28T09:48:50.000Z (6 months ago)
• Last Synced: 2025-12-30T18:55:45.203Z (5 months ago)
• Topics: gemini-cli-extensions, mcp, uv
• Language: Python
• Homepage: https://saadman.dev/uv-mcp/
• Size: 2.45 MB
• Stars: 7
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# uv-mcp 

[![geminicli.com: featured extension](https://img.shields.io/badge/geminicli.com-featured%20extension-5F55AF?style=for-the-badge&logoColor=white)](https://geminicli.com/extensions)

![Python](https://img.shields.io/badge/Python-3.11%2B-FFE873?style=for-the-badge&logo=python&logoColor=white)

![Gemini](https://img.shields.io/badge/Gemini-Powered-4285F4?style=for-the-badge&logo=google&logoColor=white)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](LICENSE)

A Model Context Protocol (MCP) server for `uv` - the fast Python package manager. `uv-mcp` provides environment diagnostics, repair capabilities, and dependency management through a Gemini CLI extension.

---

![](ext/uv_mcp_logo.png)

## Why uv-mcp?

### **Built for Modern Python**

- **Native uv integration** - Works seamlessly with uv.lock and pyproject.toml

- **PEP 668 compliant** - Respects externally-managed-environment restrictions

- **No global pollution** - All operations scoped to project environments

### **AI-Native Design**

- **MCP protocol** - Works with Claude Desktop, Claude Code, Gemini CLI

- **Natural language** - No command syntax to memorize

- **Context-aware** - Understands your project structure automatically

### **Production-Ready**

- **Deterministic** - Same diagnosis and fixes across all machines

- **CI/CD friendly** - Works in containers and managed environments

- **Auditable** - Clear logs of every operation

---

## Quick Start

### Installation

**For Gemini CLI** (Recommended):

```bash

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

```

**For Claude Desktop/Code**:

```bash

claude mcp add uv-mcp -- uv --directory /path/to/uv-mcp run uv-mcp

```

More installation options in the [full documentation](https://saadman.dev/uv-mcp/)

---

## Links

- **Documentation**: https://saadman.dev/uv-mcp/

- **GitHub**: https://github.com/saadmanrafat/uv-mcp

- **Demo Video**: https://www.youtube.com/watch?v=Tv2dUt73mM8

- **Featured On**: https://geminicli.com/extensions

- **uv Docs**: https://docs.astral.sh/uv/

- **MCP Spec**: https://modelcontextprotocol.io/

---

##  Community & Support

- **Issues**: [GitHub Issues](https://github.com/saadmanrafat/uv-mcp/issues)

- **Twitter/X**: [@saadmanrafat](https://twitter.com/saadmanrafat_)

---



**Built by [Saadman Rafat](https://github.com/saadmanrafat)**

[Install Now](https://saadman.dev/uv-mcp/guides/installation/#installation) • [Read Docs](https://saadman.dev/uv-mcp/) • [Watch Demo](https://www.youtube.com/watch?v=Tv2dUt73mM8)