Uv MCP

uv-mcp is a Python package management service based on uv, providing Python environment inspection and dependency management functions through the Model Context Protocol (MCP).

Developer tools Artificial intelligence chatbots #Python package management #Environment inspection #Dependency management #MCP service .Python

rating : 2 points

downloads : 10

update time : 2025-04-28

What is uv-mcp?

uv-mcp is a server based on the Model Context Protocol (MCP) that provides LLMs with the ability to directly access and manage Python environments through the uv tool. It allows AI assistants to handle Python dependency management, environment inspection, and troubleshooting tasks.

How to use uv-mcp?

After starting the server, AI assistants can interact with Python environments through standardized resource and tool interfaces, including querying installed packages, managing dependencies, and checking for updates.

Use cases

Suitable for scenarios such as Python development environment management, dependency conflict resolution, production environment consistency checking, and automated package management.

Main features

Environment inspectionQuery the installed Python packages and their version information

Dependency resolutionCheck the compatibility and dependency relationships between packages

Environment comparisonIdentify the differences between local and cloud/production environments

Requirement managementParse and validate requirements files

Package informationGet the metadata information of PyPI packages

Virtual environment managementCreate and manage Python virtual environments

Advantages and limitations

Advantages

Provide a unified Python environment management interface through a standardized protocol

Use the uv tool to achieve fast package installation and dependency resolution

Support comprehensive environment inspection and comparison functions

Seamlessly integrate with AI assistants for automated management

Limitations

Only support Python environment management and are not applicable to other languages

Require the pre - installation of the uv tool

Some advanced functions may require additional configuration

How to use

Install uv-mcp

Ensure that Python and the uv tool are installed, and then install uv-mcp through pip

Start the server

Use the uvx command to start the MCP server

Connect the AI assistant

Configure the AI assistant to connect to the running MCP server

Start interacting

Send commands or queries through the AI assistant to manage the Python environment

Usage examples

Check for outdated packagesQuery which installed packages in the current environment have available updates

Resolve dependency conflictsWhen two packages require different versions of the same dependency, find a compatible version combination

Synchronize development and production environmentsEnsure that the package versions in the local development environment are consistent with those in the production environment

Frequently Asked Questions

What is the difference between uv-mcp and pip?

Which software needs to be pre - installed?

How to view all available commands?

Does it support the Python 2 environment?

Related resources

uv project homepage

The official repository of the uv package manager

MCP protocol documentation

The official documentation of the Model Context Protocol

MCP Python SDK

The Python SDK for building MCP servers

uv-mcp installation guide

Detailed installation and configuration guide

🚀 uv-mcp

A Model Context Protocol (MCP) server that interacts with Python installations through uv, a fast Python package manager.

🚀 Quick Start

To start the server:

uvx uv-mcp

✨ Features

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

📚 Documentation

Overview

uv-mcp allows large language models to directly access, inspect, and manage Python environments through the uv package manager. This enables AI assistants to assist with Python dependency management, environment inspection, and troubleshooting tasks.

How It Works

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

Resources

python:packages://installed - A list of all installed packages and their versions.
python:packages://outdated - A list of installed packages with available newer versions.
python:packages://{package_name}/latest - The latest available version of a specific package.
python:packages://{package_name}/dependencies - A list of dependencies for a specific package.
python:requirements://{file_path} - Parsed content of a requirement file.

Tools

run(command: str[]) - Run a command or script.
init() - Create a new project.
add(package_name: str, version: Optional[str]) - Add a dependency to the project.
remove(package_name: str) - Remove a dependency from the project.
sync(dry_run: bool) - Install all declared dependencies and remove undeclared ones.
lock() - Update the project's lock file.
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.