NPM Search

espera

npm-search MCP Server

Um servidor Model Context Protocol que permite pesquisar pacotes npm chamando o comando npm search.

Recursos:

• Pesquisar pacotes npm usando o comando npm search
• Suporta os modos de transporte stdio e HTTP (streamable-http)
• O modo HTTP é ativado automaticamente quando a variável de ambiente PORT está definida
• Registro estruturado com Pino
• Tratamento de desligamento gracioso
• Endpoint de verificação de integridade (/health)
• Gerenciamento de sessão para transporte HTTP

Ferramentas Disponíveis

• search_npm_packages - Pesquisar pacotes npm.
  • Argumentos obrigatórios:
    • query (string): A consulta de pesquisa.

Instalação

Instalando via Smithery

Para instalar o npm-search para Claude Desktop automaticamente via Smithery:

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

Usando NPM (recomendado)

Alternativamente, você pode instalar npm-search-mcp-server via npm:

npm install -g npm-search-mcp-server

Após a instalação, você pode executá-lo como um comando usando:

npm-search-mcp-server

Usando uv

Ao usar uv nenhuma instalação específica é necessária. Nós usaremos uvx para executar diretamente npm-search-mcp-server.

Configuração

Configurar para Claude.app

Adicione às suas configurações do 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

Adicione ao seu settings.json do 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"]
  }
],

Exemplos de Interações

1. Pesquisar pacotes npm:

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

Resposta:

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

Depuração

Você pode usar o inspetor MCP para depurar o servidor. Para instalações via uvx:

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

Ou se você instalou o pacote em um diretório específico ou está desenvolvendo nele:

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

Exemplos de Perguntas para o Claude

1. "Pesquise pelo pacote express no npm"
2. "Encontre pacotes relacionados a react"
3. "Mostre-me pacotes npm para desenvolvimento web"

Docker

O servidor pode ser executado em um contêiner Docker com suporte a 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

A imagem Docker usa transporte HTTP quando a variável de ambiente PORT está definida. O servidor expõe:

• POST /mcp - Endpoint MCP principal para chamadas de ferramentas e inicialização de sessão
• GET /mcp - Endpoint de fluxo SSE para respostas em streaming (requer ID de sessão)
• DELETE /mcp - Endpoint de encerramento de sessão
• GET /health - Endpoint de verificação de integridade com status do serviço e contagem de sessões ativas

Para integração com Docker Compose:

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

Contribuindo

Incentivamos contribuições para ajudar a expandir e melhorar o npm-search-mcp-server. Se você deseja adicionar novas ferramentas relacionadas ao npm, aprimorar funcionalidades existentes ou melhorar a documentação, sua contribuição é valiosa.

Para exemplos de outros servidores MCP e padrões de implementação, consulte: https://github.com/modelcontextprotocol/servers

Pull requests são bem-vindos! Sinta-se à vontade para contribuir com novas ideias, correções de bugs ou melhorias para tornar o npm-search-mcp-server ainda mais poderoso e útil.

Licença

O npm-search-mcp-server é licenciado sob a Licença MIT. Isso significa que você está livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.