Skip to content

servers_status

CLI command for checking MCP server statuses.

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

ServersStatusCmd

Bases: BaseCmd

Command to display the status of MCP servers via the CLI.

This class adds the "servers-status" command to the main argument parser, allowing users to specify which servers to check and which state file to use. When executed, it invokes the server management logic to print a status table for the selected servers.

Methods:

Name Description
add_parser

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

Executes the status-check logic using the parsed CLI arguments.
Source code in src/mada_tools/cli/commands/servers_status.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
89
class ServersStatusCmd(BaseCmd):
    """
    Command to display the status of MCP servers via the CLI.

    This class adds the "servers-status" command to the main argument
    parser, allowing users to specify which servers to check and which
    state file to use. When executed, it invokes the server management
    logic to print a status table for the selected servers.

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

        # Check status of the servers
        manager.print_server_statuses(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/servers_status.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
76
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.
    """
    servers_status: ArgumentParser = subparsers.add_parser(
        "servers-status",
        help="Check status of MCP servers.",
        formatter_class=ArgumentDefaultsHelpFormatter,
    )
    servers_status.set_defaults(func=self.process_command)
    servers_status.add_argument(
        "-c",
        "--config",
        action="store",
        type=Path,
        help="An optional path to a server configuration file. "
        "If provided, status is only checked for the servers defined "
        "in this file.",
    )
    servers_status.add_argument(
        "-s",
        "--servers",
        action="store",
        nargs="+",
        type=str,
        help="An optional, space-delimited list of servers to check. "
        "If none are provided all servers will be shown.",
    )
    servers_status.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/servers_status.py 
78
79
80
81
82
83
84
85
86
87
88
89
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 status)
    manager = ServerManager(state_file=args.state_file)

    # Check status of the servers
    manager.print_server_statuses(server_names=args.servers, config_file=args.config)