Mateusribeirocampos Npm MCP Server

🚀 NPM MCP 服务器

这是一个提供 npm 包信息查询功能的 Model Context Protocol (MCP) 服务器，可帮助用户快速获取特定 npm 包的详细信息，还能列出热门的 npm 包，为开发者在使用 npm 包时提供便利。

🚀 快速开始

此 NPM MCP 服务器可提供 npm 包信息查询功能，下面为您介绍其安装、构建、运行及使用方法。

✨ 主要特性

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

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 NPM MCP Server for 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 模型结合使用，用于：

1. 安装前获取包信息。
2. 比较不同版本。
3. 分析依赖项。
4. 寻找流行替代品。
5. 获取快速包摘要。

🔧 技术细节

本项目使用的技术栈如下：