mcp-registry/mcp-shodan

    ==================
      
       /// MCP ///
      /// MCP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

mcp-shodan

by BurtTheCoder

Model Context Protocol (MCP) server that exposes Shodan API & CVEDB capabilities (IP recon, DNS, vulnerability and device search) as structured MCP tools.

67
10
Specialized
GitHubNPM

01

ip_lookup

Retrieve comprehensive information about an IP address, including geolocation, open ports, running services, SSL certificates, hostnames, and cloud provider details if available

02

shodan_search

Search Shodan's database of internet-connected devices

03

cve_lookup

Query detailed vulnerability information from Shodan's CVEDB

04

dns_lookup

Resolve domain names to IP addresses using Shodan's DNS service

05

reverse_dns_lookup

Perform reverse DNS lookups to find hostnames associated with IP addresses

06

cpe_lookup

Search for Common Platform Enumeration (CPE) entries by product name

07

cves_by_product

Search for vulnerabilities affecting specific products or CPEs

Installation

1. Prerequisites
• Node.js ≥ 18
• npm (comes with Node.js)
• A valid SHODAN API key
2. Clone the repository
git clone https://github.com/BurtTheCoder/mcp-shodan.git cd mcp-shodan
3. Install dependencies
npm install
4. Configure environment variables
export SHODAN_API_KEY="<your-shodan-key>" # Optionally change the default HTTP port export PORT=8080
5. Start the MCP server
npm start
6. Verify
curl "http://localhost:8080/healthz" ➜ should return {"status":"ok"} Docker (alternative) docker build -t mcp-shodan . docker run -d -p 8080:8080 -e SHODAN_API_KEY=<key> mcp-shodan

Documentation

License: MIT License
Updated 7/30/2025