🚀 NPM 服务器端工具
本工具是一个强大的 NPM 服务器端工具，为开发者提供了丰富的 NPM 包管理和分析功能，能帮助开发者更高效地管理和分析 NPM 包。
🚀 快速开始
使用 NPX
# 安装插件
npm install -g @nekzus/mcp-server
# 运行服务器
npx @nekzus/mcp-server
配置文件示例
使用 Claude Desktop
将以下内容添加到 claude_desktop_config.json：
{
"mcpServers": {
"npmAnalyzer": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@nekzus/mcp-server"]
}
}
}
配置文件位置：
- Windows：%APPDATA%/claude-desktop/claude_desktop_config.json
- macOS：~/Library/Application Support/claude-desktop/claude_desktop_config.json
- Linux：~/.config/claude-desktop/claude_desktop_config.json
使用 NPX
{
"mcpServers": {
"npm-sentinel-mcp": {
"command": "npx",
"args": [
"-y",
"@nekzus/mcp-server"
]
}
}
}
✨ 主要特性
资源接口
npm://registry：NPM 注册表接口npm://security：安全分析接口npm://metrics：软件包度量接口
工具集
| 工具名 | 功能 | 输入 | 输出 |
|---|---|---|---|
npmVersions |
获取包的所有版本 | packages（字符串数组） |
版本历史及其发布日期 |
npmLatest |
获取最新版本信息 | packages（字符串数组） |
最新版本详细信息和变更日志 |
npmDeps |
分析包依赖 | packages（字符串数组） |
完整的依赖树分析 |
npmTypes |
检查 TypeScript 支持 | packages（字符串数组） |
TypeScript 兼容状态 |
npmSize |
分析包大小 | packages（字符串数组） |
捆绑包大小和导入成本分析 |
npmVulnerabilities |
扫描安全漏洞 | packages（字符串数组） |
安全公告及严重性评级 |
npmTrends |
获取下载趋势 | packages（字符串数组）、period（"last-week" | "last-month" | "last-year"） |
时间段内的下载统计信息 |
npmCompare |
比较多个包 | packages（字符串数组） |
详细比较指标 |
npmMaintainers |
获取包维护者 | packages（字符串数组） |
维护者信息及活动情况 |
npmScore |
获取包质量分数 | packages（字符串数组） |
全面的质量度量指标 |
npmPackageReadme |
获取包 README 文件 | packages（字符串数组） |
格式化后的 README 内容 |
npmSearch |
搜索包 | query（字符串）、limit（数字，可选） |
匹配的包及其元数据 |
npmLicenseCompatibility |
检查许可证兼容性 | packages（字符串数组） |
许可证分析及兼容信息 |
npmRepoStats |
获取仓库统计 | packages（字符串数组） |
GitHub/仓库指标 |
npm |
获取包维护者 | packages（字符串数组） |
维护者信息及活动情况 |
📦 安装指南
使用 NPX
# 安装插件
npm install -g @nekzus/mcp-server
# 运行服务器
npx @nekzus/mcp-server
配置文件示例
使用 Claude Desktop
将以下内容添加到 claude_desktop_config.json：
{
"mcpServers": {
"npmAnalyzer": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@nekzus/mcp-server"]
}
}
}
配置文件位置：
- Windows：%APPDATA%/claude-desktop/claude_desktop_config.json
- macOS：~/Library/Application Support/claude-desktop/claude_desktop_config.json
- Linux：~/.config/claude-desktop/claude_desktop_config.json
使用 NPX
{
"mcpServers": {
"npm-sentinel-mcp": {
"command": "npx",
"args": [
"-y",
"@nekzus/mcp-server"
]
}
}
}
📚 详细文档
编译构建
项目结构
your-project/
├── src/
│ ├── components/
│ └── pages/
├── public/
└── package.json
构建脚本示例
{
"scripts": {
"build": "webpack --mode production",
"dev": "webpack --mode development"
}
}
开发规范
代码风格指南
- 遵循项目组的 JavaScript 代码规范。
- 确保代码格式统一，使用最新版本的 ESLint 和 Prettier。
文档编写
- 使用 JSDoc 格式为所有公共 API 编写文档。
- 保持文档与代码同步更新，确保准确性。
版本控制
- 遵循语义化版本控制规范（SEMVER）。
- 在发布新版本时，记录变更日志并推送到远程仓库。
项目贡献
贡献指南
- Fork 该项目到您的账户。
- 创建新的功能分支：
git checkout -b feature/your-feature-name - 提交您的更改：
git add . && git commit -m '描述您所做的更改' - 推送到您的仓库：
git push origin feature/your-feature-name - 创建 Pull Request 到原项目。
代码审查
- 每个提交都需要经过至少一位维护者的代码审查。
- 确保代码符合项目的质量标准和安全规范。
社区支持
提问与反馈
- 在 GitHub 仓库中提出问题：[链接到 Issues 页面]
- 加入项目 Discord 社区：[Discord 邀请链接]
感谢贡献者
感谢所有为这个项目做出贡献的志愿者和维护者，你们的努力使该项目更加优秀。
📄 许可证
MIT License
版权所有 (c) 年份 作者姓名。
根据 MIT 许可证分发。
MIT 许可证的副本见随附文件 LICENSE，或者您也可以访问 URL 获取详细信息。
Apache License 2.0
版权所有 (c) 年份 作者姓名。
根据 Apache 许可证 2.0 分发。
Apache 许可证 2.0 的副本见随附文件 LICENSE，或者您也可以访问 URL 获取详细信息。