Queries Shodan for host and network recon, CVE and exploit lookups, InternetDB data and alerts.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add shodan-server-cyreslab-ai --env SHODAN_API_KEY='<SHODAN_API_KEY>' -- node /path/to/shodan-mcp-server/build/index.js~/.codex/config.toml
[mcp_servers.shodan-server-cyreslab-ai]
command = "node"
args = ["/path/to/shodan-mcp-server/build/index.js"]
env = { SHODAN_API_KEY = "<SHODAN_API_KEY>" }
# codex mcp add shodan-server-cyreslab-ai --env SHODAN_API_KEY='<SHODAN_API_KEY>' -- node /path/to/shodan-mcp-server/build/index.js~/.cursor/mcp.json
{
"mcpServers": {
"shodan-server-cyreslab-ai": {
"command": "node",
"args": [
"/path/to/shodan-mcp-server/build/index.js"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"shodan-server-cyreslab-ai": {
"type": "stdio",
"command": "node",
"args": [
"/path/to/shodan-mcp-server/build/index.js"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"shodan-server-cyreslab-ai": {
"command": "node",
"args": [
"/path/to/shodan-mcp-server/build/index.js"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"shodan-server-cyreslab-ai": {
"command": "node",
"args": [
"/path/to/shodan-mcp-server/build/index.js"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"shodan-server-cyreslab-ai": {
"command": "node",
"args": [
"/path/to/shodan-mcp-server/build/index.js"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}Environment variables
SHODAN_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.