Skip to content

Network Tools

network

Network diagnostic tools.

get_listening_ports async 

get_listening_ports(host: Host = None) -> str

Get listening ports.

Retrieves all ports with services actively listening for connections, including protocol (TCP/UDP), bind address, port number, and process name.

Source code in src/linux_mcp_server/tools/network.py 
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
@mcp.tool(
    title="Get listening ports",
    description="Get details on listening port, protocols, and services.",
    tags={"connectivity", "network", "ports"},
    annotations=ToolAnnotations(readOnlyHint=True),
)
@log_tool_call
@disallow_local_execution_in_containers
async def get_listening_ports(
    host: Host = None,
) -> str:
    """Get listening ports.

    Retrieves all ports with services actively listening for connections,
    including protocol (TCP/UDP), bind address, port number, and process name.
    """
    cmd = get_command("listening_ports")

    returncode, stdout, stderr = await cmd.run(host=host)

    if is_successful_output(returncode, stdout):
        ports = parse_ss_listening(stdout)
        return format_listening_ports(ports)
    return f"Error getting listening ports: return code {returncode}, stderr: {stderr}"

get_network_connections async 

get_network_connections(host: Host = None) -> str

Get active network connections.

Retrieves all established and pending network connections including protocol, state, local/remote addresses and ports, and associated process information.

Source code in src/linux_mcp_server/tools/network.py 
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
@mcp.tool(
    title="Get network connections",
    description="Get detailed information about active network connections.",
    tags={"connections", "connectivity", "network"},
    annotations=ToolAnnotations(readOnlyHint=True),
)
@log_tool_call
@disallow_local_execution_in_containers
async def get_network_connections(
    host: Host = None,
) -> str:
    """Get active network connections.

    Retrieves all established and pending network connections including protocol,
    state, local/remote addresses and ports, and associated process information.
    """
    cmd = get_command("network_connections")

    returncode, stdout, stderr = await cmd.run(host=host)

    if is_successful_output(returncode, stdout):
        connections = parse_ss_connections(stdout)
        return format_network_connections(connections)
    return f"Error getting network connections: return code {returncode}, stderr: {stderr}"

get_network_interfaces async 

get_network_interfaces(host: Host = None) -> str

Get network interface information.

Retrieves all network interfaces with their operational state, IP addresses, and traffic statistics (bytes/packets sent/received, errors, dropped packets).

Source code in src/linux_mcp_server/tools/network.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
@mcp.tool(
    title="Get network interfaces",
    description="Get detailed information about network interfaces including address and traffic statistics.",
    tags={"connectivity", "interfaces", "network"},
    annotations=ToolAnnotations(readOnlyHint=True),
)
@log_tool_call
@disallow_local_execution_in_containers
async def get_network_interfaces(
    host: Host = None,
) -> str:
    """Get network interface information.

    Retrieves all network interfaces with their operational state, IP addresses,
    and traffic statistics (bytes/packets sent/received, errors, dropped packets).
    """
    interfaces = {}
    stats = {}

    # Get brief interface info
    brief_cmd = get_command("network_interfaces", "brief")
    returncode, stdout, _ = await brief_cmd.run(host=host)

    if is_successful_output(returncode, stdout):
        interfaces = parse_ip_brief(stdout)

    # Get network statistics from /proc/net/dev
    stats_cmd = get_command("network_interfaces", "stats")
    returncode, stdout, _ = await stats_cmd.run(host=host)

    if is_successful_output(returncode, stdout):
        stats = parse_proc_net_dev(stdout)

    return format_network_interfaces(interfaces, stats)