mcp-shodan

Instructions

Implementation Reference

• src/index.ts:559-592 (handler)

  Handler for the 'dns_lookup' tool. Parses input arguments using DnsLookupArgsSchema, performs batch DNS resolution via Shodan's /dns/resolve API by joining hostnames, formats the result mapping hostnames to IPs, and returns a structured JSON response.

  case "dns_lookup": {
    const parsedDnsArgs = DnsLookupArgsSchema.safeParse(args);
    if (!parsedDnsArgs.success) {
      throw new Error("Invalid dns_lookup arguments");
    }
    
    // Join hostnames with commas for the API request
    const hostnamesString = parsedDnsArgs.data.hostnames.join(",");
    
    const result: DnsResponse = await queryShodan("/dns/resolve", {
      hostnames: hostnamesString
    });
  
    // Format the response in a user-friendly way
    const formattedResult = {
      "DNS Resolutions": Object.entries(result).map(([hostname, ip]) => ({
        "Hostname": hostname,
        "IP Address": ip
      })),
      "Summary": {
        "Total Lookups": Object.keys(result).length,
        "Queried Hostnames": parsedDnsArgs.data.hostnames
      }
    };
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(formattedResult, null, 2)
        },
      ],
    };
  }

• src/index.ts:165-167 (schema)

  Zod schema defining the input parameters for the dns_lookup tool: an array of strings representing hostnames to resolve.

  const DnsLookupArgsSchema = z.object({
    hostnames: z.array(z.string()).describe("List of hostnames to resolve."),
  });

• src/index.ts:331-335 (registration)

  Tool registration in the ListToolsRequestSchema handler, defining the name, description, and input schema (converted from Zod to JSON schema) for dns_lookup.

  {
    name: "dns_lookup",
    description: "Resolve domain names to IP addresses using Shodan's DNS service. Supports batch resolution of multiple hostnames in a single query. Returns IP addresses mapped to their corresponding hostnames.",
    inputSchema: zodToJsonSchema(DnsLookupArgsSchema),
  },