使用说明

项目简介

Package Manager MCP Server 是一个为 Claude Desktop 设计的 MCP 服务器，旨在提供包管理功能。它支持 Node.js (npm) 和 Python (uv) 的包管理，包括安装、卸载、项目初始化和虚拟环境管理，从而增强 Claude Desktop 的开发能力。

主要功能点

Node.js 包管理: 支持使用 npm 管理 Node.js 包。
Python 包管理: 支持使用 uv 管理 Python 包，包括：
- 包安装和卸载
- 支持 requirements.txt 文件，并进行白名单验证
- 虚拟环境创建和管理
- 平台特定的路径检测
项目初始化: 支持初始化 Node.js ('package.json') 和 Python ('pyproject.toml') 项目。
安全特性:
- 包白名单验证
- 路径验证
- 资源限制
- 超时处理
跨平台支持: 兼容 Windows 和 Unix/Linux 系统。

安装步骤

环境准备: 确保已安装 Python 3.12+ 和 Node.js 环境。
安装 UV: 安装 UV 包管理器 (用于 Python 包管理)。
克隆仓库: 从 GitHub 克隆 'mcp-package-manager' 仓库到本地。

创建虚拟环境 (推荐):

uv venv .venv
source .venv/bin/activate  # Unix/Linux
# 或
.venv\.venv\Scripts\activate  # Windows

安装依赖: 在虚拟环境中安装项目依赖。
```
uv pip install -e .
```

服务器配置

要将 Package Manager MCP Server 集成到 Claude Desktop，需要在 'claude_desktop_config.json' 文件中配置 MCP 服务器。在 '"mcpServers"' 字段下添加以下配置：

{
  "package-manager": {
    "command": "python",
    "args": ["-m", "package_manager_mcp.server"],
    "env": {
      "ALLOWED_PACKAGES": "typescript,react,express,pandas...", // 允许安装的包白名单，逗号分隔，或使用 '*' 允许所有包
      "MAX_INSTALL_SIZE": "50000000", // 最大允许安装的包大小 (字节)
      "PROJECT_DIR": "H:/projects", // 项目根目录
      "LOG_LEVEL": "DEBUG", // 日志级别 (DEBUG, INFO, WARNING, ERROR, CRITICAL)
      "NODE_ENV": "development", // Node.js 环境
      "USE_UV": "true", // 是否使用 UV 进行 Python 包管理 (true/false)
      "UV_PATH": "uv", // UV 可执行文件路径 (可选，不填则自动检测)
      "VENV_NAME": ".venv", // 虚拟环境默认名称
      "PYTHON_VERSION": "3.12", // Python 版本
      "VENV_TIMEOUT": "30000"  // 虚拟环境创建超时时间 (毫秒)
    }
  }
}

基本使用方法

配置完成后，Claude Desktop 即可通过 MCP 协议与 Package Manager MCP Server 通信。您可以使用以下工具（Tools）来管理包和项目：

'install': 安装 npm 或 uv 包。
'uninstall': 卸载包。
'init': 初始化新项目 (创建 'package.json' 或 'pyproject.toml')。
'create_venv': 创建 Python 虚拟环境。
'add': 使用 'uv add' 命令添加 Python 包。

具体工具的使用方法和参数，请参考仓库的 'README.md' 文件和工具定义。

关键词