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. 獲取快速包摘要。

🔧 技術細節

本項目使用的技術棧如下：