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