npm Registry MCP

npm Registry MCP

Um servidor MCP (Model Context Protocol) que dá ao Claude acesso direto ao registro npm — pesquise pacotes, verifique versões, audite vulnerabilidades, compare bibliotecas e muito mais, tudo sem sair da sua conversa.

---

Por quê

Quando você está codando com o Claude e precisa escolher um pacote, verificar se algo ainda é mantido ou auditar uma dependência em busca de vulnerabilidades — normalmente você precisa parar, trocar de aba, pesquisar no Google e voltar. Este servidor elimina esse atrito completamente. O Claude pode consultar o registro npm diretamente, no contexto, no meio da conversa.

---

Ferramentas

Ferramenta	O que faz
search_packages	Pesquisa no npm por palavra-chave com pontuações de qualidade e manutenção
get_package_info	Detalhes completos — licença, mantenedores, dependências, tamanho, downloads
get_package_versions	Histórico completo de versões com datas de publicação
get_download_stats	Contagens de download em qualquer período (dia / semana / mês / ano)
check_vulnerabilities	CVEs conhecidas para uma versão específica de pacote
compare_packages	Comparação lado a lado de dois pacotes
get_changelog	Notas de versão entre duas versões, com fallback para CHANGELOG.md
get_package_readme	README completo para qualquer pacote ou versão específica

---

Exemplos de prompts

Depois de instalado, basta perguntar naturalmente ao Claude:

"What's the best package for parsing CSV files in Node?"
"Is moment.js still actively maintained?"
"Compare lodash and ramda"
"Are there any known vulnerabilities in axios 0.21.1?"
"What changed in express between v4 and v5?"
"How many downloads does react get per month?"
"Show me the README for the sharp package"

---

Instalação

Pré-requisitos

• Node.js v18 ou superior
• Claude Desktop

1. Adicionar à configuração do Claude Desktop

Abra o arquivo de configuração do Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "npm-registry": {
      "command": "npx",
      "args": ["mcp-npm-registry"]
    }
  }
}

É isso — sem clonar, sem compilar. npx cuida de tudo automaticamente.

Instalação manual (opcional)

Se preferir uma instalação global:

npm install -g mcp-npm-registry

Depois use mcp-npm-registry como comando em vez de npx mcp-npm-registry.

2. Reinicie o Claude Desktop

Feche e reabra completamente o Claude Desktop. Você deve ver um ícone de ferramentas confirmando que o servidor está conectado.

Nenhuma chave de API é necessária — o registro npm é totalmente público.

---

Desenvolvimento

# Run in dev mode (no build step needed)
npm run dev

# Build
npm run build

O servidor se comunica via stdio usando o protocolo MCP. Você pode testá-lo diretamente:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/index.js

---

Fontes de dados

Todos os dados são obtidos ao vivo de APIs públicas — sem banco de dados, sem cache, sem limites de taxa para você:

• registry.npmjs.org — metadados e versões de pacotes
• api.npmjs.org — estatísticas de download
• api.npms.io — pontuações de qualidade, manutenção e popularidade
• registry.npmjs.org/-/npm/v1/security/advisories — dados de vulnerabilidades

---

Demonstração

---

Roadmap

• get_changelog — diff entre duas versões
• README do pacote como recurso MCP
• Publicar no npm para instalação em uma linha com npx

---

Licença

MIT