Uv Docs MCP Server

# UV Documentation MCP Server An MCP server that provides programmatic access to [UV](https://docs.astral.sh/uv/) documentation through a standardized API. This server now leverages a modern, hierarchical resource structure that exposes both high‐level documentation sections and detailed command documentation (including subsections) as individual MCP resources. Tools have been streamlined, and many documentation queries are handled via the resource layer. ## Links - [UV Documentation](https://docs.astral.sh/uv/) - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) ## Quick Start 1. **Requirements:** Ensure Python 3.13+ is installed (minimum 3.10 for MCP SDK compatibility). 2. **Clone the Repository:** ```bash git clone https://github.com/StevenBtw/uv-docs-mcp.git cd uv-docs-mcp ``` 3. **Set Up Virtual Environment and Install Dependencies:** ```bash python3.13 -m venv env source env/bin/activate # On Windows use: env\\Scripts\\activate pip install -e . ``` 4. **Run the Server:** ```bash uv run uv-docs ``` *(If using Claude Desktop or other MCP clients, adjust configuration accordingly.)* ## Architecture The server is built with a modular and hierarchical design that clearly separates concerns: ```mermaid flowchart TD Client[MCP Client] --> Server[Server Layer] Server --> Resources[Resource Layer] Server --> Tools[Tools Layer] Server --> Prompts[Prompts Layer] Resources --> Cache[Cache System] Tools --> Cache ``` - **Resource Layer:** Exposes UV documentation via URIs with the scheme `uv-docs://`. Resources are structured hierarchically: - **Level 1:** Base sections (e.g., `uv-docs://cli`, `uv-docs://settings`, `uv-docs://resolver`) - **Level 2:** Individual commands (e.g., `uv-docs://cli/uv-run`, `uv-docs://cli/uv-cache`) - **Level 3:** Command subsections (e.g., `uv-docs://cli/uv-cache/uv-cache-dir`) - **Tools Layer:** Provides operational