UV Documentation

You can access UV documentation programmatically through this MCP server, which exposes a clear, hierarchical resource model and convenient tooling to search, cache, and summarize documentation data. This makes it easy to build AI assistants, dashboards, or clients that query UV docs in real time and stay up to date with caching and version checks.

How to use

Use an MCP client to connect to the UV documentation MCP server and navigate the hierarchical resources. Start by querying base sections like uv-docs://cli, uv-docs://settings, or uv-docs://resolver to discover available commands and subsections. Request specific command metadata or full documentation content for a chosen path such as uv-docs://cli/uv-cache or uv-docs://cli/uv-cache/uv-cache-dir to see detailed guidance and parameters. You can also leverage built-in tools to update cached content or perform real-time searches across the documentation when you need quick answers.

How to install

Prerequisites: ensure Python 3.13+ is installed. The MCP client tooling and server run in Python environments.

Step-by-step setup and run flow:

1. Create a Python virtual environment and install the package in editable mode.

Configuration examples

{
  "mcpServers": {
    "uv_docs": {
      "type": "stdio",
      "name": "uv_docs",
      "command": "uv",
      "args": [
        "directory",
        "/Users/steven/Git/MCP/uv-docs",
        "run",
        "uv-docs"
      ]
    }
  }
}

{
  "mcpServers": {
    "uv_docs": {
      "type": "stdio",
      "name": "uv_docs",
      "command": "uvx",
      "args": [
        "uv-docs"
      ]
    }
  }
}

Notes on caching and debugging

The server uses a version-aware cache to optimize performance. It initializes at startup, checks the live documentation version, and caches sections separately (CLI, settings, resolver). You can force a cache refresh when needed using the provided tooling.

For debugging, you can use the MCP Inspector to inspect the server interaction and the available resources. It can show a browser-accessible debugging URL for convenient inspection.

Available tools

update_cache

Update the documentation cache when the live version has changed or if a mismatch is detected.

search_documentation

Perform real-time searches over the UV documentation to locate relevant sections or commands.

summarize-docs

Generate concise summaries of documentation sections using pre-built prompt templates.