uv-mcp

Name: uv-mcp
Author: dmclain

@dmclain

Repository

About uv-mcp

MCP server for introspection of python environments

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "uv-mcp": {
      "command": "uvx",
      "args": [
        "uv-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).