uv-mcp

A Model Context Protocol (MCP) server for interacting with Python installations via uv, the fast Python package installer.

Overview

uv-mcp provides LLMs with direct access to inspect and manage Python environments through the uv package manager. This allows AI assistants to help with Python dependency management, environment inspection, and troubleshooting tasks.

Features

Environment Inspection: Query installed packages and their versions
Dependency Resolution: Check compatibility between packages
Environment Comparison: Identify differences between local and cloud/production environments
Requirement Management: Parse and validate requirements files
Package Information: Retrieve metadata about PyPI packages
Virtual Environment Management: Create and manage virtual environments

How It Works

uv-mcp implements the Model Context Protocol to expose Python environment data and package management functionality through standardized resources and tools.

Resources

python:packages://installed - List of all installed packages and versions
python:packages://outdated - List of installed packages with newer versions available
python:packages://{package_name}/latest - Latest versions available for a package
python:packages://{package_name}/dependencies - List of dependencies for a specific package
python:requirements://{file_path} - Parsed content of requirements files

Tools

run(command: str[]) - Run a command or script
init() - Create a new project
add(package_name: str, version: Optional[str]) - Add dependencies to the project
remove(package_name: str) - Remove dependencies from the project
sync(dry_run: bool) - Install all declared dependencies, uninstall anything not declared
lock() - Update the project's lockfile
pip(command: str[]) - Run a pip command
pip_install(package_name: str, version: Optional[str]) - Install a package using pip
pip_uninstall(package_name: str) - Uninstall a package using pip
pip_list() - List all installed packages using pip

Usage

To start the server:

uvx uv-mcp

Development

This project is built with the MCP Python SDK and uv.