Skip to content

restart_servers

CLI command for restarting MCP servers.

This module defines the RestartServersCmd class, which implements a command-line interface (CLI) command for restarting one or more MCP servers. It integrates with the main argument parser, allowing users to specify a configuration file, an optional list of server names, and an optional state file for tracking server status. The command invokes the server management logic to perform the restart operation.

RestartServersCmd

Bases: BaseCmd

Command to restart one or more MCP servers via the CLI.

This class adds the "restart-servers" command to the main argument parser, allowing users to specify which servers to restart and which configuration and state files to use. When executed, it invokes the server management logic to perform the restart operation.

Methods:

Name Description
add_parser

Adds the "restart-servers" subcommand and its arguments to the CLI parser.
process_command

Executes the restart logic using the parsed CLI arguments.
Source code in src/mada_tools/cli/commands/restart_servers.py 
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
class RestartServersCmd(BaseCmd):
    """
    Command to restart one or more MCP servers via the CLI.

    This class adds the "restart-servers" command to the main argument
    parser, allowing users to specify which servers to restart and which
    configuration and state files to use. When executed, it invokes the
    server management logic to perform the restart operation.

    Methods:
        add_parser:
            Adds the "restart-servers" subcommand and its arguments to the CLI parser.
        process_command:
            Executes the restart logic using the parsed CLI arguments.
    """

    def add_parser(self, subparsers: ArgumentParser):
        """
        Add the parser for this command to the main `ArgumentParser`.

        Args:
            subparsers (ArgumentParser): A subparser object to add this command to.
        """
        restart_servers: ArgumentParser = subparsers.add_parser(
            "restart-servers",
            help="Restart MCP servers.",
            formatter_class=ArgumentDefaultsHelpFormatter,
        )
        restart_servers.set_defaults(func=self.process_command)
        restart_servers.add_argument(
            "config",
            action="store",
            type=Path,
            help="Path to a server configuration file.",
        )
        restart_servers.add_argument(
            "-s",
            "--servers",
            action="store",
            nargs="+",
            type=str,
            help="An optional, space-delimited list of servers to restart. "
            "If none are provided all servers will be restarted.",
        )
        restart_servers.add_argument(
            "-f",
            "--state-file",
            action="store",
            type=Path,
            default=Path.home() / ".mada" / "server_statuses.json",
            help="Path to a file tracking server state.",
        )

    def process_command(self, args: Namespace):
        """
        Execute the logic for this CLI command.

        Args:
            args (Namespace): Parsed CLI arguments from the user.
        """
        manager = ServerManager(state_file=args.state_file)
        manager.restart_servers(config_file=args.config, server_names=args.servers)

add_parser(subparsers)

Add the parser for this command to the main ArgumentParser.

Parameters:

Name Type Description Default
subparsers ArgumentParser

A subparser object to add this command to.

 required
Source code in src/mada_tools/cli/commands/restart_servers.py 
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
def add_parser(self, subparsers: ArgumentParser):
    """
    Add the parser for this command to the main `ArgumentParser`.

    Args:
        subparsers (ArgumentParser): A subparser object to add this command to.
    """
    restart_servers: ArgumentParser = subparsers.add_parser(
        "restart-servers",
        help="Restart MCP servers.",
        formatter_class=ArgumentDefaultsHelpFormatter,
    )
    restart_servers.set_defaults(func=self.process_command)
    restart_servers.add_argument(
        "config",
        action="store",
        type=Path,
        help="Path to a server configuration file.",
    )
    restart_servers.add_argument(
        "-s",
        "--servers",
        action="store",
        nargs="+",
        type=str,
        help="An optional, space-delimited list of servers to restart. "
        "If none are provided all servers will be restarted.",
    )
    restart_servers.add_argument(
        "-f",
        "--state-file",
        action="store",
        type=Path,
        default=Path.home() / ".mada" / "server_statuses.json",
        help="Path to a file tracking server state.",
    )

process_command(args)

Execute the logic for this CLI command.

Parameters:

Name Type Description Default
args Namespace

Parsed CLI arguments from the user.

 required
Source code in src/mada_tools/cli/commands/restart_servers.py 
75
76
77
78
79
80
81
82
83
def process_command(self, args: Namespace):
    """
    Execute the logic for this CLI command.

    Args:
        args (Namespace): Parsed CLI arguments from the user.
    """
    manager = ServerManager(state_file=args.state_file)
    manager.restart_servers(config_file=args.config, server_names=args.servers)