get_nodes_overview
Monitor infrastructure node health, resource usage, running containers, and system metrics to identify performance issues and optimize resource allocation.
Instructions
Get overview of infrastructure nodes.
Returns information about all nodes in the infrastructure:
Node health and status
Resource utilization
Running containers
System metrics
Args: project_id: Project ID query: Search/filter query (optional)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| query | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/mcp_coroot/server.py:436-454 (handler)Primary MCP tool handler: the @mcp.tool()-decorated function that executes the tool logic by delegating to the implementation wrapper and ultimately to the CorootClient.
@mcp.tool() async def get_nodes_overview( project_id: str, query: str | None = None, ) -> dict[str, Any]: """Get overview of infrastructure nodes. Returns information about all nodes in the infrastructure: - Node health and status - Resource utilization - Running containers - System metrics Args: project_id: Project ID query: Search/filter query (optional) """ return await get_nodes_overview_impl(project_id, query) # type: ignore[no-any-return] - src/mcp_coroot/client.py:494-518 (helper)Helper method in CorootClient that performs the actual HTTP API request to retrieve nodes overview data from the Coroot server.
async def get_nodes_overview( self, project_id: str, query: str | None = None, ) -> dict[str, Any]: """Get infrastructure nodes overview. Args: project_id: Project ID. query: Search/filter query. Returns: Nodes overview data. """ params = {} if query: params["query"] = query response = await self._request( "GET", f"/api/project/{project_id}/overview/nodes", params=params, ) data: dict[str, Any] = response.json() return data - src/mcp_coroot/server.py:423-434 (helper)Internal implementation wrapper that calls the CorootClient method and formats the response with success indicator.
@handle_errors async def get_nodes_overview_impl( project_id: str, query: str | None = None, ) -> dict[str, Any]: """Get nodes overview.""" overview = await get_client().get_nodes_overview(project_id, query) return { "success": True, "overview": overview, } - src/mcp_coroot/server.py:436-436 (registration)FastMCP tool registration decorator applied to the handler function.
@mcp.tool()