mcpField
U
uv-mcp

uv-mcp

Local
github.com/dmclainDeveloper Tools4Updated 83w ago
Repository

About uv-mcp

uv-mcp is an MCP server for inspecting and managing Python environments through uv. It is intended for LLM-assisted dependency work and troubleshooting, exposing environment data alongside package-management tools.

Key features

  1. 01Inspect installed and outdated packages
  2. 02Check package compatibility
  3. 03Compare package sets across environments
  4. 04Parse and validate requirements files
  5. 05Manage virtual environments and dependencies

Use cases

  1. 01Review packages and versions in an environment
  2. 02Check whether dependencies are compatible
  3. 03Compare local and production environments

MCP support

The MCP server exposes Python package and requirements-file resources, along with tools for uv, pip, and environment management.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "uv": {
      "command": "uvx",
      "args": [
        "uv-mcp"
      ]
    }
  }
}
Run commanduvx uv-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiuv-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.