Shodan MCP Server

MCP server for querying the Shodan API

Catalog onlyCatalog onlySTDIO

Overview

Shodan MCP Server is a Model Context Protocol server designed for querying the Shodan API and Shodan CVEDB, providing tools for various network and security-related data lookups.

To use Shodan MCP Server, install it globally via npm, configure it in your Claude Desktop settings, and restart the application. You can also run it from source if you prefer, by cloning the repository and building it yourself.

IP Lookup: Detailed information retrieval about IP addresses. - Device Search: Search for devices based on Shodan queries. - CVE Lookup: Fetch detailed information about specific CVEs. - DNS Lookup: Resolve hostnames into IP addresses.

Performing security audits by examining device vulnerabilities.
Conducting research on IoT device security by querying Shodan's data.
Analyzing IP address information during network troubleshooting processes.

Add to your AI client

Use these steps to connect Shodan MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-shodan-burtthecoder": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-shodan-burtthecoder"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-shodan-burtthecoder": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-shodan-burtthecoder"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-shodan-burtthecoder": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-shodan-burtthecoder"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-shodan-burtthecoder": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-shodan-burtthecoder"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-shodan-burtthecoder": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-shodan-burtthecoder"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-shodan-burtthecoder": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-shodan-burtthecoder"
      ]
    }
  }
}

FAQ

How do I obtain a Shodan API key?

You can get a valid API key by creating an account on the Shodan website.

Is there a way to run the server locally?

Yes! You can clone the repository and build the server to run it locally.

What dependencies are required to run the server?

You need Node.js version 18 or later and a valid Shodan API key.

Research and data