NPM Search

Servidor MCP npm-search

Un servidor de Protocolo de Contexto de Modelo (MCP) que te permite buscar paquetes npm ejecutando el comando npm search.

Características:

• Busca paquetes npm usando el comando npm search
• Soporta modos de transporte stdio y HTTP (streamable-http)
• El modo HTTP se habilita automáticamente cuando la variable de entorno PORT está configurada
• Registro estructurado con Pino
• Manejo de apagado elegante
• Endpoint de verificación de salud (/health)
• Gestión de sesiones para transporte HTTP

Herramientas Disponibles

• search_npm_packages - Busca paquetes npm.
  • Argumentos requeridos:
    • query (cadena): La consulta de búsqueda.

Instalación

Instalación mediante Smithery

Para instalar npm-search para Claude Desktop automáticamente a través de Smithery:

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

Usando NPM (recomendado)

Alternativamente, puedes instalar npm-search-mcp-server vía npm:

npm install -g npm-search-mcp-server

Después de la instalación, puedes ejecutarlo como comando usando:

npm-search-mcp-server

Usando uv

Cuando se usa uv no se necesita instalación específica. Usaremos uvx para ejecutar directamente npm-search-mcp-server.

Configuración

Configurar para Claude.app

Agrega a tu configuración de Claude:

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

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

Configurar para Zed

Agrega a tu settings.json de Zed:

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

Ejemplos de Interacciones

1. Buscar paquetes npm:

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

Respuesta:

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

Depuración

Puedes usar el inspector MCP para depurar el servidor. Para instalaciones con uvx:

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

O si has instalado el paquete en un directorio específico o estás desarrollando en él:

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

Ejemplos de Preguntas para Claude

1. "Busca el paquete express en npm"
2. "Encuentra paquetes relacionados con react"
3. "Muéstrame paquetes npm para desarrollo web"

Docker

El servidor se puede ejecutar en un contenedor Docker con soporte de transporte HTTP:

# 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

La imagen Docker usa transporte HTTP cuando la variable de entorno PORT está configurada. El servidor expone:

• POST /mcp - Endpoint MCP principal para llamadas de herramientas e inicialización de sesiones
• GET /mcp - Endpoint de flujo SSE para respuestas en streaming (requiere ID de sesión)
• DELETE /mcp - Endpoint de terminación de sesiones
• GET /health - Endpoint de verificación de salud con estado del servicio y conteo de sesiones activas

Para integración con Docker Compose:

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

Contribuciones

Animamos las contribuciones para ayudar a expandir y mejorar npm-search-mcp-server. Ya sea que quieras agregar nuevas herramientas relacionadas con npm, mejorar la funcionalidad existente o mejorar la documentación, tu aporte es valioso.

Para ejemplos de otros servidores MCP y patrones de implementación, consulta: https://github.com/modelcontextprotocol/servers

¡Las solicitudes de extracción son bienvenidas! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras para hacer npm-search-mcp-server aún más potente y útil.

Licencia

npm-search-mcp-server está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.