Skip to content

Fast MCP integration for NetworksDB API - Query IP addresses, organizations, ASNs, and DNS records using natural language through Model Context Protocol

Notifications You must be signed in to change notification settings

MorDavid/NetworksDB-MCP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NetworksDB-MCP

Model Context Protocol (MCP) Server for NetworksDB

NetworksDB-MCP is a powerful integration that brings the capabilities of Model Context Protocol (MCP) Server to NetworksDB, enabling natural language queries for network intelligence, IP geolocation, organization details, and DNS information.

🌐 Seamless Network Intelligence with AI!
Query network data, track organizations, and analyze IP infrastructure using natural language.

🔍 What is NetworksDB-MCP?

NetworksDB-MCP combines the power of:

  • NetworksDB: Comprehensive database for IP, organization, and network intelligence
  • Model Context Protocol (MCP): An open protocol for creating custom AI tools
  • Natural Language Processing: Convert plain English queries into NetworksDB API calls

📱 Community

Join our Telegram channel for updates, tips, and discussion:

✨ Features

  • Natural Language Interface: Query network data using plain English
  • Comprehensive Analysis Categories:
    • 🔑 API Key management and usage tracking
    • 🌐 IP address information and geolocation
    • 🏢 Organization search and infrastructure mapping
    • 🔢 ASN information and network relationships
    • 📝 DNS and reverse DNS intelligence
    • 🔍 Mass reverse DNS for network ranges

📋 Prerequisites

  • NetworksDB API key
  • Python 3.8 or higher
  • MCP Client

🔧 Installation

  1. Clone this repository:

    git clone https://github.com/mordavid/NetworksDB-MCP.git
    cd NetworksDB-MCP
  2. Install dependencies:

    pip install -r requirements.txt
  3. Configure the MCP Server

    "mcpServers": {
        "NetworksDB-MCP": {
            "command": "python",
            "args": [
                "<Your_Path>\\NetworksDB-MCP.py"
            ],
            "env": {
                "NETWORKSDB_API_KEY": "<Your_API_Key>"
            }
        }
    }

🚀 Usage

Example queries you can ask through the MCP:

  • "Find all information about IP 8.8.8.8"
  • "Search for organizations named Google"
  • "Get geolocation for IP 1.1.1.1"
  • "Show me DNS records for example.com"
  • "Find all networks owned by Microsoft"
  • "Get reverse DNS for IP range 192.168.1.0/24"

Core commands:

  • key_info - Get API key info and usage stats
  • ip_info - Get IP address details
  • ip_geo - Get IP geolocation
  • org_search - Search organizations
  • org_info - Get org details
  • org_networks - List networks owned by org
  • asn_info - Get ASN information
  • asn_networks - List networks for ASN
  • dns - Get DNS records
  • reverse_dns - Get reverse DNS for IP
  • mass_reverse_dns - Bulk reverse DNS lookup

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • The NetworksDB team for providing comprehensive network intelligence APIs
  • The MCP community for advancing AI-powered tooling

Note: This is not an official NetworksDB product. NetworksDB-MCP is a community-driven integration between NetworksDB and MCP.