npm-search MCP Server

npm-search MCP サーバー

npm search コマンドを呼び出して npm パッケージを検索できる、Model Context Protocol サーバーです。

機能：

• npm search コマンドを使った npm パッケージの検索
• stdio と HTTP（streamable-http）の両方のトランスポートモードをサポート
• PORT 環境変数が設定されている場合、HTTP モードを自動的に有効化
• Pino による構造化ログ
• グレースフルシャットダウン処理
• ヘルスチェックエンドポイント（/health）
• HTTP トランスポート用のセッション管理

利用可能なツール

• search_npm_packages - npm パッケージを検索します。
  • 必須の引数：
    • query（string）：検索クエリ。

インストール

Smithery 経由でインストール

Smithery 経由で npm-search を Claude Desktop に自動インストールするには：

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

やり取りの例

1. npm パッケージを検索します。

{
  "name": "search_npm_packages",
  "arguments": {
    "query": "express"
  }
}

応答：

{
  "results": [
    {
      "name": "express",
      "description": "Fast, unopinionated, minimalist web framework",
      "version": "4.17.1",
      "author": "TJ Holowaychuk",
      "license": "MIT"
    },
    ...
  ]
}

デバッグ

MCP Inspector を使ってサーバーをデバッグできます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector npx -y npm-search-mcp-server

または、特定のディレクトリにパッケージをインストールした場合や、開発中の場合：

cd path/to/servers/src/npm-search
npx @modelcontextprotocol/inspector uv run npm-search-mcp-server

Claude への質問例

1. 「npm で express パッケージを検索して」
2. 「react 関連のパッケージを探して」
3. 「ウェブ開発用の npm パッケージを見せて」

Docker

サーバーは HTTP トランスポートに対応した Docker コンテナで実行できます。

# Build the image
docker build -t mcp/npm-search .

# Run the container (default port 3009)
docker run -p 3009:3009 mcp/npm-search

# Run with custom port via environment variable
docker run -p 3009:3009 -e PORT=3009 mcp/npm-search

Docker イメージは、PORT 環境変数が設定されている場合に HTTP トランスポートを使用します。サーバーは次のエンドポイントを公開します。

• POST /mcp - ツール呼び出しとセッション初期化用のメイン MCP エンドポイント
• GET /mcp - 応答のストリーミング用 SSE ストリームエンドポイント（セッション ID が必要）
• DELETE /mcp - セッション終了エンドポイント
• GET /health - サービスの状態とアクティブなセッション数を含むヘルスチェックエンドポイント

Docker Compose と連携する場合：

services:
  npm-search-mcp:
    build: .
    ports:
      - "3009:3009"
    environment:
      PORT: 3009

コントリビューション

npm-search-mcp-server の拡張と改善に役立つコントリビューションを歓迎します。npm 関連の新しいツールの追加、既存機能の強化、ドキュメントの改善など、皆さまからのご意見は貴重です。

ほかの MCP サーバーや実装パターンの例については、こちらをご覧ください。 https://github.com/modelcontextprotocol/servers

プルリクエストを歓迎します。新しいアイデア、バグ修正、機能強化など、npm-search-mcp-server をさらに強力で便利にするためのコントリビューションをぜひお寄せください。

ライセンス

npm-search-mcp-server は MIT ライセンスのもとで公開されています。MIT ライセンスの利用規約に従う限り、ソフトウェアの使用、変更、配布は自由です。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。