shodan-mcp

How to use shodan-mcp

git clone https://github.com/vorotaai/shodan-mcp.git

{
  "mcpServers": {
    "shodan-mcp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "SHODAN_API_KEY", "shodan-mcp"],
      "env": {
        "SHODAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

What is shodan-mcp?

shodan-mcp is a Python MCP server for Claude Desktop, Cursor, Windsurf with uvx/pip, docker, git clone. Shodan MCP server for Claude, Cursor & VS Code. 20 tools for passive reconnaissance, CVE/CPE intelligence, DNS analysis, and device search. This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Key capabilities

• Tool access support
• Shell commands support
• Document generation support
• Anthropic provider support
• Google provider support
• pyproject.toml config support
• Dockerfile config support

Compatibility and setup

Install or run shodan-mcp using uvx/pip. Check Vorota-ai/shodan-mcp for the latest setup command.

• Built for Python
• Built for Docker
• Install or run with uvx/pip
• Install or run with docker
• Install or run with git clone
• Works with Claude Desktop
• Works with Cursor
• Works with Windsurf

MCP metadata is retained with field-level source and confidence evidence. Undetected values remain unknown.

Requirements and access

Security and permissions

Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.

When to use shodan-mcp

• Use it for connecting agents to external tools and data.
• Use it for integrations workflows.
• Use it for coding workflows.
• Use it for data workflows.
• Use it for claude desktop users.

Built with

Verified compatibility and discovery

Frequently asked questions