Shodan MCP Server
An unofficial MCP (Model Context Protocol) server that provides Claude with access to Shodan for IP address lookups, service discovery, and vulnerability scanning.
Features
- Host Lookup: Get detailed information about any IPv4 address
- Search: Query Shodan's database using filters (e.g.,
apache port:80
,country:US
) - Count: Get result counts for queries without fetching full data
- Account Info: Check your Shodan API usage and limits
Installation
- Clone the repository:
- Install dependencies using Poetry:
- Set up your Shodan API key:Get your API key from Shodan Account.
Usage
Running the Server
Connecting to Claude
Add this configuration to your Claude Desktop config.json
file:
macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
Replace /path/to/your/shodan_mcp
with the actual path to this project.
Available Tools
1. shodan_host_lookup
Look up detailed information about a specific IP address.
Parameters:
ip
(required): IPv4 address to look uphistory
(optional): Include historical data (default: false)minify
(optional): Return minimal data (default: false)
Example:
2. shodan_search
Search Shodan's database using query filters.
Parameters:
query
(required): Shodan search querylimit
(optional): Maximum results to return (1-100, default: 10)
Example queries:
apache port:80
- Apache servers on port 80country:US ssl:true
- SSL servers in the USproduct:nginx
- Nginx serversport:22
- SSH servers
3. shodan_count
Get the total count of results for a query without fetching the actual data.
Parameters:
query
(required): Shodan search query
4. shodan_info
Get information about your Shodan API account (credits, plan, etc.).
Parameters: None
Example Usage with Claude
Once connected, you can ask Claude things like:
- "Look up the IP address 1.1.1.1 using Shodan"
- "Search for Apache servers in the US"
- "How many SSH servers are there globally?"
- "What's my current Shodan API usage?"
Development
Project Structure
Dependencies
mcp
- Model Context Protocol libraryshodan
- Official Shodan Python librarypython-decouple
- Environment variable management
License
MIT License - see LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Disclaimer
This is an unofficial tool. Please respect Shodan's terms of service and rate limits.
This server cannot be installed
Provides Claude with access to Shodan for IP address lookups, service discovery, and vulnerability scanning, allowing users to query information about hosts, count results, and check API usage.
Related MCP Servers
- -securityAlicense-qualityMCP server for querying the Shodan API and Shodan CVEDB. This server provides tools for IP lookups, device searches, DNS lookups, vulnerability queries, CPE lookups, and more.Last updated -766318JavaScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides access to Shodan and VirusTotal APIs for cybersecurity analysis, enabling analysts to perform network intelligence operations including host lookups, vulnerability analysis, and threat intelligence gathering.Last updated -1TypeScript
- AsecurityAlicenseAqualityProvides access to Shodan API functionality, enabling AI assistants to query information about internet-connected devices for cybersecurity research and threat intelligence.Last updated -2323JavaScriptMIT License
- -securityFlicense-qualityA WebSocket server that provides MCP interface for searching and retrieving information about internet-connected devices, IP addresses, DNS data, and CVE vulnerabilities through the Shodan API.Last updated -JavaScript