Btwiuse Npm Search MCP Server

🚀 npm-search MCP 服務器

npm-search MCP 服務器是一個模型上下文協議（Model Context Protocol）服務器，它允許你通過調用 npm search 命令來搜索 npm 包，為開發者提供便捷的包搜索服務。

✨ 主要特性

• 提供 search_npm_packages 工具，可用於搜索 npm 包。
• 支持多種安裝方式，如通過 Smithery、NPM 或 uv 進行安裝。
• 可配置為 Claude.app 和 Zed 使用。
• 支持調試和項目構建。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 可自動為 Claude Desktop 安裝 npm-search：

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

使用 NPM（推薦）

你也可以通過 npm 安裝 npm-search-mcp-server：

npm install -g npm-search-mcp-server

安裝完成後，可通過以下命令運行它：

npm-search-mcp-server

使用 uv

當使用 uv 時，無需特定安裝。我們將使用 uvx 直接運行 npm-search-mcp-server。

📚 詳細文檔

可用工具

• search_npm_packages - 搜索 npm 包。
  • 必要參數：
    • query (字符串)：搜索查詢。

配置說明

配置為 Claude.app 使用

添加到你的 Claude 設置中：

"mcpServers": {
  "npm-search": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
}

"mcpServers": {
  "npm-search": {
    "command": "uvx",
    "args": ["npm-search-mcp-server"]
  }
}

配置為 Zed 使用

添加到你的 Zed settings.json 中：

"context_servers": {
  "npm-search-mcp-server": {
    "command": "npx",
    "args": ["-y", "npm-search-mcp-server"]
  }
},

"context_servers": {
  "npm-search-mcp-server": {
    "command": "uvx",
    "args": ["npm-search-mcp-server"]
  }
}

💻 使用示例

基礎用法

以下是一個請求和響應示例： 請求：

{
  "intent": "search_npm_packages",
  "arguments": {
    "query": "node"
  }
}

響應：

{
  "result": {
    "packages": [
      {
        "name": "node",
        "version": "16.14.2",
        "description": "Node.js: A platform built on Chrome's JavaScript runtime."
      },
      // 更多結果...
    ]
  }
}

🔧 技術細節

調試

要調試服務器，請運行：

npm run debug

然後使用支持 LSP 的編輯器（如 VS Code）連接到端點 127.0.0.1:3000。

構建

你可以通過以下命令構建項目：

docker build -t npm-search-mcp-server .

📄 許可證

該項目是開源的，使用 MIT 許可證。有關貢獻和更多信息，請訪問 GitHub 倉庫。