🚀 uv-mcp

uv-mcp 是一个通过 uv（快速 Python 包管理器）与 Python 安装进行互动的模型上下文协议（MCP）服务器。它允许大语言模型直接访问、检查和管理 Python 环境，为 AI 助手处理 Python 依赖管理、环境检查和故障排除任务提供了便利。

🚀 快速开始

要启动服务器，可使用以下命令：

uvx uv-mcp

✨ 主要特性

• 环境检查：可查询已安装的包及其版本。
• 依赖解析：能检查包之间的兼容性。
• 环境对比：可识别本地与云端/生产环境之间的差异。
• 需求管理：能够解析并验证需求文件。
• 包信息：可检索 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() - 列出所有已安装的包。

🔧 技术细节

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