NetOps MCP - Network Operations Tools MCP Server

A comprehensive Model Context Protocol (MCP) server that provides access to essential network operations and infrastructure tools through a standardized interface.

🚀 Features

Network Connectivity Tools

• Ping: Test host connectivity with customizable packet count and timeout
• Traceroute: Trace network path with configurable max hops
• MTR: Monitor network path with real-time statistics
• Telnet: Test port connectivity using telnet
• Netcat: Test port connectivity using netcat

HTTP/API Testing Tools

• cURL: Execute HTTP requests with full control over headers, methods, and data
• HTTPie: Alternative HTTP client with simplified syntax
• API Testing: Validate API endpoints with expected status codes

DNS Tools

• nslookup: Query DNS records with various record types
• dig: Advanced DNS querying tool
• host: Simple DNS lookup utility

Network Discovery Tools

• Nmap: Network scanning and service enumeration
• Port Scanning: Targeted port scanning capabilities
• Service Discovery: Identify running services on targets

System Monitoring Tools

• SS: Socket statistics and connection monitoring
• Netstat: Network statistics and connection information
• ARP: Address Resolution Protocol table management
• ARPing: Test ARP connectivity

System Information Tools

• System Status: CPU, memory, and disk usage monitoring
• Process List: Running process enumeration
• Required Tools Check: Verify system tool availability

📋 Prerequisites

Required System Tools

The following tools must be installed on the system:

# Network tools
curl, ping, traceroute, mtr, telnet, nc (netcat)

# DNS tools
nslookup, dig, host

# Network discovery
nmap

# System tools
ss, netstat, arp, arping

# HTTP tools
httpie (optional, for enhanced HTTP testing)

Python Requirements

• Python 3.8+
• uv package manager (recommended)

🛠️ Installation

Using uv (Recommended)

# Clone the repository
git clone https://github.com/alpadalar/NetOpsMCP.git
cd NetOpsMCP

# Install dependencies using uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Using pip

# Clone the repository
git clone https://github.com/alpadalar/NetOpsMCP.git
cd NetOpsMCP

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e .

Using Docker

# Build and run with Docker Compose
docker compose up -d

# Or build manually
docker build -t netopsmcp .
docker run -p 8815:8815 netopsmcp

🚀 Quick Start

1. Start the Server

# Using Python directly
python -m netops_mcp.server_http --host 0.0.0.0 --port 8815

# Using Docker
docker compose up -d

# Using the provided script
./start_http_server.sh

2. Test the Server

# Health check
curl http://localhost:8815/health

# Test system requirements
curl -X POST http://localhost:8815/netops-mcp \
  -H "Content-Type: application/json" \
  -d '{"method": "check_required_tools", "params": {}}'

3. Example Usage

# Ping a host
result = ping_host("google.com", count=4, timeout=10)

# Test HTTP endpoint
result = curl_request("https://httpbin.org/get", method="GET")

# DNS lookup
result = nslookup_query("google.com", record_type="A")

# Network scan
result = nmap_scan("192.168.1.1", ports="1-1000", scan_type="basic")

📖 API Reference

Network Connectivity

ping_host(host: str, count: int = 4, timeout: int = 10)

Test connectivity to a host using ping.

Parameters:

• host: Target hostname or IP address
• count: Number of ping packets (default: 4)
• timeout: Timeout in seconds (default: 10)

Returns: Ping statistics and results

traceroute_path(target: str, max_hops: int = 30, timeout: int = 30)

Trace network path to a t

... View full README on GitHub