Skip to content

stop_servers

CLI command for stopping MCP servers.

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

StopServersCmd

Bases: BaseCmd

CLI command for stopping MCP servers.

This class adds the "stop-servers" command to the main argument parser, allowing users to specify which servers to stop and which state file to use. When executed, it invokes the server management logic to stop the specified servers.

Methods:

Name Description
add_parser

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

Executes the stop logic using the parsed CLI arguments.
Source code in src/mada_tools/cli/commands/stop_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
84
85
86
87
88
class StopServersCmd(BaseCmd):
    """
    CLI command for stopping MCP servers.

    This class adds the "stop-servers" command to the main argument
    parser, allowing users to specify which servers to stop and which
    state file to use. When executed, it invokes the server management
    logic to stop the specified servers.

    Methods:
        add_parser:
            Adds the "stop-servers" subcommand and its arguments to the CLI parser.
        process_command:
            Executes the stop 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.
        """
        stop_servers: ArgumentParser = subparsers.add_parser(
            "stop-servers",
            help="Stop running MCP servers.",
            formatter_class=ArgumentDefaultsHelpFormatter,
        )
        stop_servers.set_defaults(func=self.process_command)
        stop_servers.add_argument(
            "-c",
            "--config",
            action="store",
            type=Path,
            help="An optional path to a server configuration file. "
            "If provided, only the servers defined in this file will be stopped.",
        )
        stop_servers.add_argument(
            "-s",
            "--servers",
            action="store",
            nargs="+",
            type=str,
            help="An optional, space-delimited list of servers to stop. "
            "If none are provided all running servers will be stopped.",
        )
        stop_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.
        """
        # Create ServerManager (only needs state for stopping)
        manager = ServerManager(state_file=args.state_file)

        # Stop the servers
        manager.stop_servers(server_names=args.servers, config_file=args.config)

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/stop_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
74
75
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.
    """
    stop_servers: ArgumentParser = subparsers.add_parser(
        "stop-servers",
        help="Stop running MCP servers.",
        formatter_class=ArgumentDefaultsHelpFormatter,
    )
    stop_servers.set_defaults(func=self.process_command)
    stop_servers.add_argument(
        "-c",
        "--config",
        action="store",
        type=Path,
        help="An optional path to a server configuration file. "
        "If provided, only the servers defined in this file will be stopped.",
    )
    stop_servers.add_argument(
        "-s",
        "--servers",
        action="store",
        nargs="+",
        type=str,
        help="An optional, space-delimited list of servers to stop. "
        "If none are provided all running servers will be stopped.",
    )
    stop_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/stop_servers.py 
77
78
79
80
81
82
83
84
85
86
87
88
def process_command(self, args: Namespace):
    """
    Execute the logic for this CLI command.

    Args:
        args (Namespace): Parsed CLI arguments from the user.
    """
    # Create ServerManager (only needs state for stopping)
    manager = ServerManager(state_file=args.state_file)

    # Stop the servers
    manager.stop_servers(server_names=args.servers, config_file=args.config)