https://github.com/jakbin/shodan-mcp
A Model Context Protocol (MCP) toolkit for integrating Shodan's powerful search and intelligence capabilities into your applications.
https://github.com/jakbin/shodan-mcp
mcp mcp-server python3 shodan-api shodan-mcp shodan-python
Last synced: about 1 month ago
JSON representation
A Model Context Protocol (MCP) toolkit for integrating Shodan's powerful search and intelligence capabilities into your applications.
- Host: GitHub
- URL: https://github.com/jakbin/shodan-mcp
- Owner: jakbin
- Created: 2025-06-17T17:33:07.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-17T17:45:58.000Z (12 months ago)
- Last Synced: 2025-06-17T18:43:42.387Z (12 months ago)
- Topics: mcp, mcp-server, python3, shodan-api, shodan-mcp, shodan-python
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Shodan MCP Toolkit
A Model Context Protocol (MCP) toolkit for integrating Shodan's powerful search and intelligence capabilities into your applications.
## Features
- Advanced Shodan search with filters and facets
- IP information lookup (open ports, services, location)
- DNS and reverse DNS lookups
- Domain info and subdomain enumeration
- On-demand scanning (requires upgraded Shodan API access)
- Network alert creation and management
- Vulnerability analysis with CVE tracking
- API usage and limits info
- Historical scan data (premium access required)
## Requirements
- Python 3.7+
- Shodan API key (set as the `SHODAN_API_KEY` environment variable)
## Installation
```bash
pip install shodan-mcp
```
## Configuration
Set your Shodan API key as an environment variable:
```bash
export SHODAN_API_KEY=your_shodan_api_key
```
## Testing
Test with Model Context Protocol Inspector:
```bash
npx @modelcontextprotocol/inspector uv run shodan-mcp
```
## Usage
Add this in your MCP client:
```bash
uv run shodan-mcp
```