Skip to content

Process Tools

processes

Process management tools.

get_process_info async 

get_process_info(
    pid: Annotated[
        int,
        Field(
            description="Process ID",
            ge=1,
            examples=[1, 1234, 65535],
        ),
    ],
    host: Host = None,
) -> str

Get detailed information about a specific process.

Retrieves comprehensive process details including CPU/memory usage, process state, virtual/resident memory size, controlling terminal, and additional metadata from /proc//status when available.

Source code in src/linux_mcp_server/tools/processes.py 
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
@mcp.tool(
    title="Process details",
    description="Get information about a specific process.",
    tags={"performance", "processes"},
    annotations=ToolAnnotations(readOnlyHint=True),
)
@log_tool_call
@disallow_local_execution_in_containers
async def get_process_info(
    pid: t.Annotated[
        int,
        Field(description="Process ID", ge=1, examples=[1, 1234, 65535]),
    ],
    host: Host = None,
) -> str:
    """Get detailed information about a specific process.

    Retrieves comprehensive process details including CPU/memory usage, process
    state, virtual/resident memory size, controlling terminal, and additional
    metadata from /proc/<pid>/status when available.
    """
    # Get process details with ps
    ps_cmd = get_command("process_info", "ps_detail")
    returncode, stdout, _ = await ps_cmd.run(host=host, pid=pid)

    if returncode != 0:
        return f"Process with PID {pid} does not exist."

    if not stdout:
        return f"Process with PID {pid} does not exist."

    # Try to get more details from /proc
    proc_status = None
    status_cmd = get_command("process_info", "proc_status")
    status_code, status_stdout, _ = await status_cmd.run(host=host, pid=pid)

    if is_successful_output(status_code, status_stdout):
        proc_status = parse_proc_status(status_stdout)

    return format_process_detail(stdout, proc_status, pid)

list_processes async 

list_processes(host: Host = None) -> str

List all running processes.

Retrieves a snapshot of all running processes with details including PID, user, CPU/memory usage, process state, start time, and command line.

Source code in src/linux_mcp_server/tools/processes.py 
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
@mcp.tool(
    title="List processes",
    description="List running processes",
    tags={"performance", "processes"},
    annotations=ToolAnnotations(readOnlyHint=True),
)
@log_tool_call
@disallow_local_execution_in_containers
async def list_processes(
    host: Host = None,
) -> str:
    """List all running processes.

    Retrieves a snapshot of all running processes with details including PID,
    user, CPU/memory usage, process state, start time, and command line.
    """
    cmd = get_command("list_processes")
    returncode, stdout, _ = await cmd.run(host=host)

    if is_successful_output(returncode, stdout):
        processes = parse_ps_output(stdout)
        return format_process_list(processes)
    return "Error executing ps command"