windows-network-utils-mcp

Sohaib-2/windows-network-utils-mcp

3.2

If you are the rightful owner of windows-network-utils-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A powerful MCP server built with FastMCP providing essential Windows networking tools for Claude Desktop integration.

Tools
  1. get_local_ip

    Returns your machine's local IP address

  2. get_public_ip

    Fetches your public IP using ipify API

  3. domain_to_ip

    Resolves domain to IP address

  4. ping_host

    Ping a host and return results

  5. check_port

    Check if a specific port is open

  6. scan_ports

    Scan multiple ports on a host

  7. get_active_connections

    Show active network connections

  8. get_network_interfaces

    List all network adapters

  9. scan_local_network

    Fast discovery of devices on local network

🛠️ Windows Network Utilities MCP Server

Demo

A powerful MCP (Model Context Protocol) server built with FastMCP providing essential Windows networking tools for Claude Desktop integration. Connect AI to your network infrastructure for seamless network management and troubleshooting.

🚀 Features

  • 🏠 IP Management: Local and public IP address detection and monitoring
  • 🌐 DNS Operations: Domain resolution, fast lookup capabilities
  • 📡 Network Testing: Ping, connectivity checks
  • 🔍 Port Operations: Port scanning, availability checks, service detection
  • 🖥️ Interface Management: Network adapter listing, configuration viewing
  • 🔗 Connection Monitoring: Active connections, netstat integration
  • 🌍 Network Discovery: Fast local network scanning with threading
  • ⚡ Built with FastMCP: Lightning-fast MCP server implementation

📋 Requirements

  • Windows 10/11
  • Python 3.8+
  • Claude Desktop

🔧 Installation

  1. Clone the repository

    git clone https://github.com/Sohaib-2/windows-network-utils-mcp.git
    cd windows-network-utils-mcp
    
  2. Create and activate virtual environment

    python -m venv venv
    venv\Scripts\activate
    
  3. Install dependencies

    pip install -r requirements.txt
    
  4. Test the server

    python network_utils.py
    

Note: This server is built with FastMCP for optimal performance and easy integration.

⚙️ Claude Desktop Integration

  1. Open Claude Desktop configuration

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the MCP server configuration

    {
      "mcpServers": {
        "network-utils": {
          "command": "C:\\path\\to\\your\\project\\venv\\Scripts\\python.exe",
          "args": ["C:\\path\\to\\your\\project\\network_utils.py"]
        }
      }
    }
    

    Important: Use the full path to the Python executable inside your virtual environment, not just python If you are using virtual env.

  3. Restart Claude Desktop

🛠️ Available Tools (9 Essential Tools)

ToolDescription
get_local_ip()Returns your machine's local IP address
get_public_ip()Fetches your public IP using ipify API
domain_to_ip()Resolves domain to IP address
ping_host()Ping a host and return results
check_port()Check if a specific port is open
scan_ports()Scan multiple ports on a host
get_active_connections()Show active network connections
get_network_interfaces()List all network adapters
scan_local_network()Fast discovery of devices on local network

💡 Usage Examples

Ask Claude Desktop:

  • "What's my local IP address?"
  • "Ping google.com"
  • "Scan my local network for devices"
  • "Check if port 80 is open on example.com"
  • "Show my active network connections"

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

🐛 Issues

Found a bug? Please create an issue with:

  • Windows version
  • Python version
  • Error message
  • Steps to reproduce