Skip to content

trading_agent.doctor.checks.mcp_servers_check

Checks that mcp_servers.json can be read, and names the servers in it.

It does not start the servers; trading-agent mcp list does that.

Typical usage example:

result = McpServersCheck(Path('mcp_servers.json')).run()

McpServersCheck 

McpServersCheck(servers_file)

Bases: DoctorCheck

Checks the MCP server list.

Creates the check.

Parameters:

Name Type Description Default
servers_file Path

The mcp_servers.json file.

 required
Source code in src/trading_agent/doctor/checks/mcp_servers_check.py 
21
22
23
24
25
26
27
def __init__(self, servers_file: Path):
    """Creates the check.

    Args:
        servers_file (Path): The mcp_servers.json file.
    """
    self._servers_file = servers_file

run 

run()

Reads the file.

Returns:

Type Description
CheckResult

OK with the server names, OK with a note when there is no file, or failed when it cannot be read, in which case the gateway will not start.
Source code in src/trading_agent/doctor/checks/mcp_servers_check.py 
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
def run(self) -> doctor_check.CheckResult:
    """Reads the file.

    Returns:
        doctor_check.CheckResult: OK with the server names, OK with a note when there is no file, or failed when it cannot be read, in which case the gateway will not start.
    """
    try:
        servers = mcp_server_configuration.McpConfigurationReader(
            self._servers_file
        ).read()
    except mcp_server_configuration.McpConfigurationError as error:
        return doctor_check.CheckResult(
            doctor_check.CheckStatus.FAILED,
            f'{error}; the gateway will not start until it is fixed.',
        )
    if not servers:
        return doctor_check.CheckResult(
            doctor_check.CheckStatus.OK,
            f'No MCP servers configured ({self._servers_file} is absent or empty).',
        )
    names = []
    for server in servers:
        names.append(f'{server.name} ({server.type})')
    return doctor_check.CheckResult(
        doctor_check.CheckStatus.OK,
        f'{len(servers)} configured: {", ".join(names)}. Run `trading-agent mcp list` to connect to them.',
    )