MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:1228-1243 (registration)

  MCP tool registration for 'get_node' using @mcp.tool() decorator

  @mcp.tool()
  async def get_node(project_id: str, node_id: str) -> dict[str, Any]:
      """Get detailed information about a specific infrastructure node.
  
      Retrieves comprehensive metrics and information about a node including:
      - Resource usage (CPU, memory, disk, network)
      - Running containers
      - System information
      - Health status
  
      Args:
          project_id: Project ID
          node_id: Node ID
      """
      return await get_node_impl(project_id, node_id)  # type: ignore[no-any-return]

• src/mcp_coroot/server.py:1218-1226 (handler)

  Handler implementation that calls the CorootClient.get_node and formats the response

  @handle_errors
  async def get_node_impl(project_id: str, node_id: str) -> dict[str, Any]:
      """Get node details."""
      node = await get_client().get_node(project_id, node_id)
      return {
          "success": True,
          "node": node,
      }

• src/mcp_coroot/client.py:932-946 (helper)

  CorootClient helper method that performs the HTTP GET request to retrieve node details from the Coroot API

  async def get_node(self, project_id: str, node_id: str) -> dict[str, Any]:
      """Get detailed information about a specific node.
  
      Args:
          project_id: Project ID.
          node_id: Node ID.
  
      Returns:
          Node details including metrics and containers.
      """
      response = await self._request(
          "GET", f"/api/project/{project_id}/node/{node_id}"
      )
      data: dict[str, Any] = response.json()
      return data