mcp-shodan

mcp-shodan

ShodanApiNetworkReconnaissanceVulnerabilityIntelligenceDnsCveJavascriptEdgeComputingCloudPythonGoRubyR

About This Server

MCP server for querying the Shodan API

Server Information

šŸ“‹ Overview:

The webpage is the GitHub repository page for "mcp-shodan," a Model Context Protocol (MCP) server developed by BurtTheCoder. This server is designed to query the Shodan API and Shodan CVEDB, providing network intelligence and security services. It offers tools for IP reconnaissance, DNS operations, vulnerability tracking, and device discovery, with structured output for easy analysis.


ā­ Key Points:
  • mcp-shodan is a Model Context Protocol (MCP) server

  • Designed for querying Shodan API and CVEDB

  • Provides network intelligence and security services

  • Offers tools for IP reconnaissance, DNS operations, vulnerability tracking, and device discovery


  • šŸ” Main Findings:
  • The server can be installed via Smithery or manually through npm.

  • Running from source requires Node.js v18 or later.

  • Key features include network reconnaissance, DNS operations, vulnerability intelligence, and device discovery.

  • Tools available are IP Lookup, Shodan Search, CVE Lookup, DNS Lookup, Reverse DNS Lookup, CPE Lookup, and CVEs by Product.

  • MIT License.

  • Comprehensive error handling is provided for various scenarios.


  • šŸ“Š Details:
  • Installation methods: Smithery (recommended) and Manual

  • Installation via Smithery: `npx -y @smithery/cli install @burtthecoder/mcp-shodan --client claude`

  • Manual installation requires npm and Claude Desktop Configuration

  • Configuration file locations: macOS (`~/Library/Application Support/Claude/claudedesktopconfig.json`) and Windows (`%APPDATA%\Claude\claudedesktopconfig.json`)

  • Error handling includes API key issues (invalid keys, rate limits) and module loading problems.

  • Development mode can be activated with `npm run dev`

  • Version History: from v1.0.0 to v1.0.12, including major features additions (Reverse DNS, CPEs, CVEs)


šŸŽÆ Conclusion:
The mcp-shodan repository provides a tool for querying Shodan API, facilitating network security-related tasks, is actively developed, offers multiple installation options and detailed instructions, and is licensed under MIT.

Server Features

Network Reconnaissance

Query detailed information about IP addresses, including open ports, services, and vulnerabilities.

DNS Operations

Forward and reverse DNS lookups for domains and IP addresses.

Vulnerability Intelligence

Access to Shodan's CVEDB for detailed vulnerability information, CPE lookups, and product-specific CVE tracking.

Device Discovery

Search Shodan's database of internet-connected devices with advanced filtering.

Provider Information

Burtthecoder logo

Burtthecoder

cloud Provider

Visit Provider Website

Quick Actions

Visit Website

MCP Configuration

Available Tools

ip_lookupshodan_searchcve_lookupdns_lookupreverse_dns_lookupcpe_lookupcves_by_product