uv-mcp

一个模型上下文协议 (MCP) 服务器，用于通过快速 Python 包安装器 uv 与 Python 安装进行交互。

概述

uv-mcp 为 LLM 提供直接访问权限，以通过 uv 包管理器检查和管理 Python 环境。 这允许 AI 助手帮助处理 Python 依赖管理、环境检查和故障排除任务。

特性

• 环境检查: 查询已安装的包及其版本
• 依赖关系解析: 检查包之间的兼容性
• 环境比较: 识别本地环境与云/生产环境之间的差异
• 需求管理: 解析和验证需求文件
• 包信息: 检索有关 PyPI 包的元数据
• 虚拟环境管理: 创建和管理虚拟环境

工作原理

uv-mcp 实现了 模型上下文协议，通过标准化的资源和工具公开 Python 环境数据和包管理功能。

资源

• python:packages://installed - 所有已安装的包和版本的列表
• python:packages://outdated - 具有可用更新版本的已安装包的列表
• python:packages://{package_name}/latest - 包的最新可用版本
• python:packages://{package_name}/dependencies - 特定包的依赖关系列表
• python:requirements://{file_path} - 需求文件的已解析内容

工具

• run(command: str[]) - 运行命令或脚本
• init() - 创建一个新项目
• add(package_name: str, version: Optional[str]) - 将依赖项添加到项目
• remove(package_name: str) - 从项目中删除依赖项
• sync(dry_run: bool) - 安装所有声明的依赖项，卸载任何未声明的依赖项
• lock() - 更新项目的锁定文件
• pip(command: str[]) - 运行 pip 命令
• pip_install(package_name: str, version: Optional[str]) - 使用 pip 安装包
• pip_uninstall(package_name: str) - 使用 pip 卸载包
• pip_list() - 使用 pip 列出所有已安装的包

用法

要启动服务器：

uvx uv-mcp

开发

该项目是使用 MCP Python SDK 和 uv 构建的。