Overview: Shodan MCP Server

Title

Shodan MCP Server – A Model Context Protocol (MCP) server for querying Shodan’s API and CVEDB, providing structured access to network intelligence, vulnerability data, and device discovery.

How to Use

Quick Installation (Recommended)

1. Via Smithery (Automated Setup):

   npx -y @smithery/cli install @burtthecoder/mcp-shodan --client claude  

2. Manual Installation:
   • Install globally via npm:

     npm install -g @burtthecoder/mcp-shodan  

   • Add to Claude Desktop config (claude_desktop_config.json) with your Shodan API key.
   • Restart Claude Desktop.

Alternative Setup (From Source)

1. Clone, build, and configure manually for custom modifications.

Key Features

• Network Reconnaissance: IP lookups, open ports, services, and geolocation.
• DNS Operations: Forward/reverse DNS resolution.
• Vulnerability Intelligence: CVE lookups, CVEDB access, and product-specific vulnerability tracking.
• Device Discovery: Advanced search for internet-connected devices.

Use Cases

• Security Research: Identify vulnerable systems via CVE lookups and Shodan scans.
• Threat Intelligence: Gather IP/hostname data for threat analysis.
• IT & DevOps: Audit network exposure and cloud assets.
• Penetration Testing: Discover exploitable devices using Shodan’s search filters.

Requirements

• Node.js v18+
• Valid Shodan API Key

For troubleshooting (e.g., API errors), verify key permissions and check rate limits.