What is Uv Mcp

uv-mcp is a Model Context Protocol (MCP) server designed for introspection and management of Python environments using the uv package manager.

Use cases

Use cases for uv-mcp include troubleshooting package compatibility issues, managing project dependencies, comparing local and production environments, and automating the setup of Python projects.

How to use

To use uv-mcp, you can interact with it through various commands to inspect installed packages, manage dependencies, and handle virtual environments.

Key features

Key features include environment inspection, dependency resolution, environment comparison, requirement management, package information retrieval, and virtual environment management.

Where to use

uv-mcp can be used in software development, data science, and any Python-based projects that require efficient management of dependencies and environments.

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.