Btwiuse Npm Search MCP Server

🚀 npm-search MCP サーバ

このサーバは、モデルコンテキストプロトコル（Model Context Protocol）を用いて、npm search コマンドを呼び出し、npm パッケージを検索することができます。

🚀 クイックスタート

npm-search MCP サーバを使用することで、簡単に npm パッケージを検索できます。以下に、インストール方法や使用例を紹介します。

✨ 主な機能

• search_npm_packages ツールを使用して、npm パッケージを検索できます。
  • 必要パラメータ:
    • query (文字列)：検索クエリ。

📦 インストール

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 を実行します。

📚 ドキュメント

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"]
  }
}

💻 使用例

基本的な使用法

以下は、npm パッケージを検索するためのリクエストとレスポンスの例です。

リクエスト：

{
  "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 リポジトリ を参照してください。