NPM Package Search

🚀 NPM MCP 服务器

这是一个提供 npm 包信息查询功能的 Model Context Protocol (MCP) 服务器，能帮助用户轻松获取 npm 包的详细信息，还可列出热门 npm 包。

🚀 快速开始

本服务器提供便捷的安装、构建和运行方式，以下为你详细介绍。

✨ 主要特性

• 包搜索：用于获取特定 npm 包的详细信息。
• 热门包：列出最受欢迎的 10 个 npm 包。

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 NPM MCP 服务器到 Claude Desktop：

npx -y @smithery/cli install @mateusribeirocampos/npm-mcp-server --client claude

手动安装

npm install

📦 构建步骤

npm run build

📦 运行方法

npm start

开发模式：

npm run dev

💻 使用示例

基础用法

该服务器主要提供以下两种功能：

1. searchNpmPackage 工具

获取特定 npm 包的详细信息。该工具返回全面的包信息，包括包名、最新版本、描述、作者信息、主页 URL、仓库 URL、依赖项列表。

const result = await server.tools.searchNpmPackage({ packageName: "react" });

示例响应：

{
  "name": "react",
  "version": "18.2.0",
  "description": "React 是一个用于构建用户界面的 JavaScript 库。",
  "author": "Meta 开源",
  "homepage": "https://reactjs.org/",
  "repository": {
    "url": "https://github.com/facebook/react.git"
  },
  "dependencies": {
    "loose-envify": "^1.1.0"
  }
}

2. popular-packages 资源

列出最受欢迎的 10 个 npm 包，按流行程度排序。每个包的信息包括包名、描述、当前版本。 资源 URI：npm://popular 示例响应：

[
  {
    "name": "lodash",
    "description": "Lodash 模块化工具集",
    "version": "4.17.21"
  },
  // ... 更多包
]

📚 详细文档

此 MCP 服务器可与 AI 模型集成，用于：

• 安装前获取包信息
• 比较不同版本的包
• 分析依赖项
• 寻找流行替代方案
• 获取快速包摘要

🔧 技术细节

本项目使用了以下技术：

• TypeScript
• Model Context Protocol SDK
• Node-fetch
• Zod