📦 NPM Helper - A tool to help your ai assistant with npm package management.🤖

📦 NPM Helper MCP

产品定位

NPM Helper MCP 是一个专注于 NPM 依赖管理的工具，旨在帮助开发者高效管理项目依赖，确保依赖项的兼容性和最新性。

核心功能

1. npm-check-updates 工具
2. checkUpdates: 扫描 package.json 中的过时依赖
3. upgradePackages: 将依赖升级到最新版本
4. filterUpdates: 检查特定包的更新
5. resolveConflicts: 处理依赖冲突
6. setVersionConstraints: 配置版本升级规则

7. runDoctor: 迭代运行升级和测试以检测破坏性更改

8. NPM 搜索工具

9. searchPackages: 在 npmjs.org 注册表中搜索包
10. fetchPackageContent: 从 npm 包页面提取内容
11. getPackageVersions: 获取包的版本历史
12. getPackageDetails: 获取详细的包元数据

适用场景

• 项目依赖管理：自动检查和更新项目依赖，确保兼容性和最新性。
• 包探索：搜索和获取 npm 包的详细信息，帮助开发者选择适合的包。
• 冲突解决：处理依赖冲突，确保项目稳定运行。

工具列表

1. check_updates: 扫描 package.json 中的过时依赖。
2. upgrade_packages: 升级依赖到最新版本。
3. filter_updates: 检查特定包的更新。
4. resolve_conflicts: 处理依赖冲突。
5. set_version_constraints: 配置版本升级规则。
6. run_doctor: 迭代运行升级和测试以检测破坏性更改。
7. search_npm: 搜索 npm 包。
8. fetch_package_content: 从 npm 包页面提取内容。
9. get_package_versions: 获取包的版本历史。
10. get_package_details: 获取详细的包元数据。

常见问题解答

1. 连接问题
2. 确保 LLM 应用程序正确配置了 Model Context Protocol。
3. 检查 .json 文件是否有错误，或验证启动命令是否正确。

4. 如果本地运行，请验证 index.js 文件的路径。必要时使用绝对路径。

5. 获取帮助

6. 检查 GitHub issues 以查找类似问题和解决方案。
7. 创建新问题并详细描述您的问题。

🚀 安装指南

使用依赖

确保已安装以下内容： - Node.js (版本 18.x 或更高) - npm (版本 8.x 或更高)

安装教程

选项 1: 使用 npx 运行

npx -y @pinkpixel/npm-helper-mcp

选项 2: 本地安装

npm install -g npm-helper-mcp
npm-helper-mcp

选项 3: 从源代码安装

git clone https://github.com/pinkpixel-dev/npm-helper-mcp.git
cd npm-helper-mcp
npm install
npm run build
npm start

调试方式

1. 确保服务器已正确启动并运行。
2. 使用提供的工具和参数进行测试，例如：

{
  "name": "check_updates",
  "arguments": {
    "packagePath": "./package.json",
    "filter": ["react", "lodash"],
    "peer": true,
    "minimal": true,
    "packageManager": "npm"
  }
}

1. 检查响应格式是否符合预期：

{
  "status": "success" | "error",
  "data": {},
  "message": "Human-readable message"
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。