MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:403-421 (handler)

  The MCP tool handler function for 'get_applications_overview', decorated with @mcp.tool(). It delegates to the implementation helper.

  @mcp.tool()
  async def get_applications_overview(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get overview of all applications in a project.
  
      Returns a high-level view of all applications including:
      - Application health status
      - Key performance indicators
      - Resource usage
      - Recent incidents
  
      Args:
          project_id: Project ID
          query: Search/filter query (optional)
      """
      return await get_applications_overview_impl(project_id, query)  # type: ignore[no-any-return]

• src/mcp_coroot/server.py:390-401 (helper)

  Helper implementation that calls the CorootClient's get_applications_overview method and formats the response.

  @handle_errors
  async def get_applications_overview_impl(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get applications overview."""
      overview = await get_client().get_applications_overview(project_id, query)
      return {
          "success": True,
          "overview": overview,
      }

• src/mcp_coroot/client.py:468-492 (helper)

  CorootClient method that executes the HTTP GET request to retrieve applications overview from the Coroot API.

  async def get_applications_overview(
      self,
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get applications overview.
  
      Args:
          project_id: Project ID.
          query: Search/filter query.
  
      Returns:
          Applications overview data.
      """
      params = {}
      if query:
          params["query"] = query
  
      response = await self._request(
          "GET",
          f"/api/project/{project_id}/overview/applications",
          params=params,
      )
      data: dict[str, Any] = response.json()
      return data