uv-mcp

一个通过uv（快速Python包管理器）与Python安装互动的模型上下文协议（MCP）服务器。

概览

uv-mcp允许大语言模型直接访问并检查和管理Python环境，通过uv包管理器。这使得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() - 列出所有已安装的包

使用方法

要启动服务器：

uvx uv-mcp

开发

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