MCP Server for Coroot

Instructions

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()