shodan-mcp

How to use shodan-mcp

git clone https://github.com/vorotaai/shodan-mcp.git
cd shodan-mcp
uv sync --all-groups
shodan-mcp

{
  "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. 4 tools work free without an API ke. 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

Available tools

Technical details

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

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

Explore related resources

Frequently asked questions