uv-mcp

What is uv-mcp?

uv-mcp is a Model Context Protocol (MCP) server that gives LLMs direct access to inspect and manage Python environments using the fast Python package installer uv. It is built for developers and AI assistants that need to handle Python dependency management, environment inspection, and troubleshooting tasks programmatically.

How to use uv-mcp?

Start the server by running uvx uv-mcp in your terminal. Once running, it exposes Python environment data and package management functions as standardized MCP resources and tools that any MCP client can consume.

Key features of uv-mcp

• Query installed packages and their versions
• Check compatibility between packages
• Identify differences between local and production environments
• Parse and validate requirements files
• Retrieve metadata about PyPI packages
• Create and manage virtual environments

Use cases of uv-mcp

• An AI assistant resolves dependency conflicts in a Python project by inspecting installed packages and checking compatibility.
• Identify outdated packages and automatically generate an upgrade plan.
• Compare the packages in a local development environment with a CI or production environment.
• Parse and validate a requirements.txt file for correctness before deployment.
• Automate the creation and setup of a new virtual environment for a project.

FAQ from uv-mcp

What is the purpose of uv-mcp?

uv-mcp is an MCP server that allows LLMs to interact with Python installations via the uv package manager, enabling tasks like inspecting environments, managing dependencies, and running pip commands.

How do I start the uv-mcp server?

Run the command uvx uv-mcp in your terminal. This launches the server using the uvx runner.

What resources does uv-mcp expose?

It exposes resources such as the list of installed packages, outdated packages, latest versions, dependencies of a package, and parsed content of requirements files.

What tools does uv-mcp provide?

It provides tools to run commands, initialize a project, add/remove dependencies, sync/lock environments, and execute pip operations (install, uninstall, list, pip commands).

What are the runtime dependencies of uv-mcp?

The server is built with the MCP Python SDK and requires uv (the Python package manager) to be installed on the system.