Repolode
w0h1v

w0h1v/mcp-shodan

Servidor MCP que dá a agentes de IA acesso à API do Shodan e ao CVEDB para buscar dispositivos na internet e obter inteligência sobre hosts, DNS e CVEs.

Alternativa open source a:Shodan

Estrelas
187
Forks
31
Issues abertas
3
Último commit
anteontem

O que é?

mcp-shodan é um servidor MCP que conecta agentes de IA, como Claude, Codex e Gemini CLI, à API do Shodan e ao Shodan CVEDB. Com um IP, hostname, consulta de busca, produto ou CVE, o agente recebe portas abertas e banners, detalhes de certificados TLS, registros DNS e a gravidade das vulnerabilidades, além dos dados de EPSS e do status no KEV.

O servidor disponibiliza onze ferramentas somente de leitura, divididas em três grupos: consultas de rede (informações de hosts, busca de dispositivos, contagens, subdomínios e resolução de DNS em lote), inteligência de vulnerabilidades do CVEDB (detalhes de CVEs, consulta de CPE e CVEs por produto) e ferramentas auxiliares para listar filtros de busca e mostrar os créditos restantes da API. As ferramentas gratuitas são identificadas como tal, e as chamadas ao CVEDB não precisam de chave de API.

Ele funciona via stdio para clientes desktop ou como serviço de streaming HTTP e requer Node.js 20 ou superior e uma chave própria da API do Shodan. As entradas são validadas com schemas do zod antes do envio das requisições, e a chave é enviada somente para api.shodan.io.

Recursos principais

  • 01Reconhecimento de hosts em endereços IPv4 e IPv6, incluindo portas, produtos, CVEs e detalhes de TLS.
  • 02Busca de dispositivos usando a sintaxe de consulta do Shodan, com paginação e detalhamento por facetas.
  • 03Consultas gratuitas que retornam apenas contagens, para estimar o tamanho de uma busca antes de gastar créditos.
  • 04Consultas de CVE e CPE com dados de CVSS, EPSS e KEV via CVEDB.
  • 05Consultas DNS diretas e reversas em lote, além de enumeração de subdomínios.
  • 06Transporte via stdio ou streaming HTTP, com suporte a imagem Docker.

Casos de uso

  • Perguntar a um agente de IA quais serviços estão expostos em determinado IP durante análises de segurança.
  • Verificar se uma CVE consta no catálogo KEV e qual a probabilidade de exploração segundo a pontuação EPSS.
  • Estimar o tamanho de uma busca na internet com consultas gratuitas de contagem antes de executar buscas pagas.
  • Enumerar subdomínios e resolver registros DNS para inventariar a superfície de ataque externa.

Início rápido

  1. 1

    Obtenha uma chave de API do Shodan na página da sua conta

  2. 2

    Adicione o servidor ao Claude Code

    claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan

Antes de usar

  • Você precisa de uma chave de API do Shodan própria, paga ou vinculada a uma assinatura. Para usar filtros de pesquisa, também é necessária uma assinatura ou um plano pago.
  • O transporte HTTP não tem autenticação, portanto deve ser mantido no localhost ou atrás de um proxy com autenticação.

Em coleções

Tópicos

Perguntas frequentes

O que é mcp-shodan?
Servidor MCP que dá a agentes de IA acesso à API do Shodan e ao CVEDB para buscar dispositivos na internet e obter inteligência sobre hosts, DNS e CVEs. mcp-shodan é um servidor MCP que conecta agentes de IA, como Claude, Codex e Gemini CLI, à API do Shodan e ao Shodan CVEDB. Com um IP, hostname, consulta de busca, produto ou CVE, o agente recebe portas abertas e banners, detalhes de certificados TLS, registros DNS e a gravidade das vulnerabilidades, além dos dados de EPSS e do status no KEV.
mcp-shodan é gratuito? Qual é a licença?
mcp-shodan é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-shodan ainda é mantido?
Manutenção ativa. O último commit de mcp-shodan foi em 4 de nov. de 2026.
Para que posso usar mcp-shodan?
Perguntar a um agente de IA quais serviços estão expostos em determinado IP durante análises de segurança. Verificar se uma CVE consta no catálogo KEV e qual a probabilidade de exploração segundo a pontuação EPSS. Estimar o tamanho de uma busca na internet com consultas gratuitas de contagem antes de executar buscas pagas. Enumerar subdomínios e resolver registros DNS para inventariar a superfície de ataque externa.
Como instalar mcp-shodan?
Obtenha uma chave de API do Shodan na página da sua conta Adicione o servidor ao Claude Code: claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan
Onde consigo mcp-shodan?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/w0h1v/mcp-shodan

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados

Ferramenta open source completa de inteligência de fontes abertas que verifica sites sob demanda, incluindo DNS, SSL, headers, informações do servidor e configurações de segurança.

35,4 mil+87 esta semana2,9 milTypeScriptMITAtualizado ontem