Shodan MCP Server

Name: Shodan MCP Server
Author: X3r0K

@X3r0K

About Shodan MCP Server

This is a Model Context Protocol (MCP) server that provides access to the Shodan API. It allows you to programmatically query Shodan for information about devices, vulnerabilities, and more.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "shodan-mcp-server-x3r0k": {
      "command": "docker",
      "args": [
        "run",
        "-e",
        "SHODAN_API_KEY=your_api_key_here",
        "-p",
        "3000:3000",
        "shodan-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Shodan MCP Server?

Shodan MCP Server is a Model Context Protocol (MCP) server that provides programmatic access to the Shodan API, enabling queries about devices, vulnerabilities, and more. It is designed for developers who want to integrate Shodan intelligence into their applications.

How to use Shodan MCP Server?

Install the server from the repository, configure it with your Shodan API key as an environment variable (SHODAN_API_KEY), and use MCP client tools to call functions such as get_ip_info, dns_lookup, get_vulnerabilities, cve_info, and search. Example usage with the @modelcontextprotocol/sdk is provided.

Key features of Shodan MCP Server

Query detailed host information by IP address
Perform DNS lookups for domain names
Retrieve CVE details for specific vulnerabilities
Track vulnerabilities associated with an IP address
Search Shodan’s database using their search syntax

Use cases of Shodan MCP Server

Investigate devices and services exposed on a given IP
Resolve hostnames to IP addresses for reconnaissance
Look up known vulnerabilities (CVEs) for security research
Monitor which vulnerabilities affect a specific server over time

FAQ from Shodan MCP Server

What prerequisites are needed to use Shodan MCP Server?

You need a Shodan API key (obtained from https://account.shodan.io/) and Node.js installed on your system.

How do I configure the Shodan API key?

Set the SHODAN_API_KEY environment variable in your MCP client settings file (e.g., ~/.config/mcp/settings.json) under the server’s env block.

Which tools does Shodan MCP Server expose?

It exposes five tools: get_ip_info, dns_lookup, get_vulnerabilities, cve_info, and search.

Can I use Shodan MCP Server without Node.js?

The server is built with Node.js and requires a Node runtime to run. It communicates via standard I/O and can be invoked from any MCP client, but the server itself depends on Node.js.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K