📦 NPM Helper-一个帮助你的ai助手管理NPM包的工具。🤖 ](https://www.npmjs.com/package/@pinkpixel/npm-helper-mcp)
用于NPM依赖管理的模型上下文协议服务器。此服务器提供NPM包搜索工具和更新NPM包的工具，确保您的项目的依赖关系是最新的，并更新到最新的兼容版本，而不会出现任何冲突或麻烦。
作为基线，为了安全升级任何项目的package.json，您的助手可以在“peer”参数设置为true的情况下调用upgradePackagets工具。这可能不会将您的所有依赖项更新到最新版本，但它会安全地将它们升级到最新的兼容版本，而不会出现任何错误。
如果你正在寻找所有依赖项的完整升级，你的助手有很多工具和参数可以安全地探索。参数选项和示例在下面的“可用工具”部分提供。您还可以在'docs'目录中找到更多信息。
如果你正在探索添加到项目中的新包的选项，或者你正在寻找特定包的信息，也有一些工具可以从npmjs中搜索和检索信息。
✨ 特性
npm检查更新工具
- 🔍 检查更新：扫描package.json以查找过时的依赖项
- 🚀 升级包：将依赖项升级到最新版本
- 🔎 过滤器更新：检查特定软件包的更新
- 🔄 解决冲突：处理依赖关系冲突
- ⚙️ setVersionConstraints：配置版本升级规则
- 🩺 run医生：迭代运行升级和测试以检测破坏性更改
NPM搜索工具
- 🔍 搜索软件包：在npmjs.org注册表中搜索软件包
- 📝 fetchPackageContent：从npm包页面中抓取和提取内容
- 📋 getPackageVersions：检索包的版本历史记录
- 📝 getPackageDetails：获取详细的包元数据
🚀 npm助手mcp安装指南
本指南将帮助您设置和运行npm helper mcp服务器。
📋 先决条件
在开始之前，请确保已安装以下内容：
- Node.js（18.x或更高版本）
- npm（8.x或更高版本）
🔧 配置
npm助手mcp服务器实现了模型上下文协议，使其能够与支持该协议的LLM应用程序通信。
配置因应用而异。通常，大多数mcp客户端应用程序都有一个.json配置文件，或者一个输入运行服务器命令的地方。在大多数情况下，这两个选项中的一个应该有效。
选项1：使用npx运行
使用服务器最简单的方法是使用npx运行它，这不需要本地安装。根据您的mcp客户端，使用以下两种方法之一：
- 将json配置复制并粘贴到应用程序的mcp配置文件中。
{
"mcpServers": {
"npm-helper": {
"command": "npx",
"args": [
"-y",
"@pinkpixel/npm-helper-mcp"
]
}
}
}- 在应用程序的mcp配置设置中输入运行服务器的命令。
npx -y @pinkpixel/npm-helper-mcp选项2：本地安装
如果您希望在本地安装服务器，可以使用以下命令：
# Install the package globally
npm install -g npm-helper-mcp配置：
- 将json配置复制并粘贴到应用程序的mcp配置文件中。
{
"mcpServers": {
"npm-helper": {
"command": "npx",
"args": [
"-y",
"@pinkpixel/npm-helper-mcp"
]
}
}
}- 在应用程序的mcp配置设置中输入运行服务器的命令。
npm-helper-mcp选项3：从源代码安装
# Clone the repository
git clone https://github.com/pinkpixel-dev/npm-helper-mcp.git
cd npm-helper-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Optionally run/test the server
npm start配置：
- 将json配置复制并粘贴到应用程序的mcp配置文件中。
{
"mcpServers": {
"npm-helper": {
"command": "node",
"args": [
"/path/to/npm-helper-mcp/dist/index.js"
]
}
}
}- 在应用程序的mcp配置设置中输入运行服务器的命令。
node /path/to/npm-helper-mcp/dist/index.js与LLM一起使用
此服务器遵循模型上下文协议，允许像Claude这样的LLM使用它。LLM可以使用服务器的工具来执行各种npm操作。
可用工具
工具：check_updates
扫描package.json以查找过时的依赖项。
参数：
packagePath（可选）：package.json文件的路径（默认：./package.json）filter（可选）：要检查的包名称列表reject（可选）：要排除的包名称列表target（可选）：要升级到的目标版本（最新、最新、最大、最小、补丁、semver）interactive（可选）：启用选择更新的交互模式peer（可选）：检查已安装软件包的对等依赖关系minimal（可选）：不要升级版本范围已经满足的较新版本packageManager（可选）：要使用的包管理器（npm、yarn、pnpm、deno、bun、staticRegistry）
例子：
{
"name": "check_updates",
"arguments": {
"packagePath": "./package.json",
"filter": ["react", "lodash"],
"peer": true,
"minimal": true,
"packageManager": "npm"
}
}工具：升级_包
将依赖项升级到最新版本。
参数：
packagePath（可选）：package.json文件的路径（默认：./package.json）upgradeType（可选）：要升级到的目标版本（最新、最新、最大、最小、补丁、semver）interactive（可选）：启用选择更新的交互模式peer（可选）：检查已安装软件包的对等依赖关系minimal（可选）：不要升级版本范围已经满足的较新版本packageManager（可选）：要使用的包管理器（npm、yarn、pnpm、deno、bun、staticRegistry）
例子：
{
"name": "upgrade_packages",
"arguments": {
"upgradeType": "minor",
"peer": true,
"minimal": true,
"packageManager": "yarn"
}
}工具：filter_updates
检查特定软件包的更新。
参数：
packagePath（可选）：package.json文件的路径（默认：./package.json）filter（必填）：要检查的包名称列表upgrade（可选）：是升级package.json文件还是只检查minimal（可选）：不要升级版本范围已经满足的较新版本packageManager（可选）：要使用的包管理器（npm、yarn、pnpm、deno、bun、staticRegistry）
例子：
{
"name": "filter_updates",
"arguments": {
"filter": ["react", "react-dom"],
"upgrade": false,
"minimal": true
}
}工具：resolve_conconflicts
使用对等依赖关系处理依赖关系冲突。
参数：
packagePath（可选）：package.json文件的路径（默认：./package.json）upgrade（可选）：是升级package.json文件还是只检查minimal（可选）：不要升级版本范围已经满足的较新版本packageManager（可选）：要使用的包管理器（npm、yarn、pnpm、deno、bun、staticRegistry）
例子：
{
"name": "resolve_conflicts",
"arguments": {
"upgrade": true,
"packageManager": "npm"
}
}工具：设置变量约束
配置版本升级规则。
参数：
packagePath（可选）：package.json文件的路径（默认：./package.json）target（必填）：目标版本约束策略（最新、最新、最大、次要、补丁、semver）removeRange（可选）：从最终软件包版本中删除版本范围upgrade（可选）：是升级package.json文件还是只检查minimal（可选）：不要升级版本范围已经满足的较新版本packageManager（可选）：要使用的包管理器（npm、yarn、pnpm、deno、bun、staticRegistry）
例子：
{
"name": "set_version_constraints",
"arguments": {
"target": "minor",
"removeRange": false,
"upgrade": true,
"packageManager": "pnpm"
}
}工具：run_doctor
迭代安装升级并运行测试以识别损坏的升级。它会自动恢复中断的升级并保持正常工作。
参数：
packagePath（可选）：package.json文件的路径（默认：./package.json）doctorInstall（可选）：要使用的自定义安装脚本（默认：“npm install”或“yarn”）doctorTest（可选）：要使用的自定义测试脚本（默认：'npm test'）packageManager（可选）：要使用的包管理器（npm、yarn、pnpm、deno、bun、staticRegistry）
例子：
{
"name": "run_doctor",
"arguments": {
"packagePath": "./package.json",
"doctorInstall": "npm ci",
"doctorTest": "npm run test:ci",
"packageManager": "npm"
}
}工具：search_npm
搜索npm包。
参数：
query（必填）：搜索npm包查询maxResults（可选）：返回的最大结果数（默认值：10）
例子：
{
"name": "search_npm",
"arguments": {
"query": "react state management",
"maxResults": 5
}
}工具：fetch_package_content
从npm包页面获取并解析详细内容。
参数：
url（必填）：npm包页面的URL
例子：
{
"name": "fetch_package_content",
"arguments": {
"url": "https://www.npmjs.com/package/react"
}
}工具：get_package_versions
获取npm包的可用版本。
参数：
packageName（必填）：npm包的名称
例子：
{
"name": "get_package_versions",
"arguments": {
"packageName": "react"
}
}工具：get_package_details
获取有关npm包的详细信息。
参数：
packageName（必填）：npm包的名称
例子：
{
"name": "get_package_details",
"arguments": {
"packageName": "react"
}
}📝 响应格式
所有工具均以标准格式返回响应：
{
"status": "success" | "error",
"data": {}, // Tool-specific data
"message": "Human-readable message"
}🆘 故障排除
连接问题\*\*：
- 确保您的LLM应用程序已正确配置为使用模型上下文协议。
- 请检查您的.json文件是否有任何错误，或验证您的start命令是否正确。
- 如果在本地运行，请验证index.js文件的路径。必要时使用绝对路径。
获取帮助
如果您遇到此处未涵盖的任何问题：
- 检查 对于类似的问题和解决方案。
- 创建一个新问题，详细描述您的问题。
📄 许可证
麻省理工学院
🙏 鸣谢
由以下材料制成❤️ 由粉红色像素
