MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:307-331 (handler)

  Primary MCP tool handler for get_application_logs, registered via @mcp.tool() decorator. Defines input schema via type hints and docstring, calls implementation function.

  async def get_application_logs(
      project_id: str,
      app_id: str,
      from_timestamp: int | None = None,
      to_timestamp: int | None = None,
      query: str | None = None,
      severity: str | None = None,
  ) -> dict[str, Any]:
      """Get application logs with pattern analysis.
  
      Retrieves application logs with automatic pattern detection
      and grouping. Supports filtering by time range, search query,
      and severity level.
  
      Args:
          project_id: Project ID
          app_id: Application ID (format: namespace/kind/name)
          from_timestamp: Start timestamp (optional)
          to_timestamp: End timestamp (optional)
          query: Log search query (optional)
          severity: Filter by severity level (optional)
      """
      return await get_application_logs_impl(  # type: ignore[no-any-return]
          project_id, app_id, from_timestamp, to_timestamp, query, severity
      )

• src/mcp_coroot/server.py:284-304 (handler)

  Core handler implementation that encodes the app_id and invokes the CorootClient to fetch application logs from the API.

  @handle_errors
  async def get_application_logs_impl(
      project_id: str,
      app_id: str,
      from_timestamp: int | None = None,
      to_timestamp: int | None = None,
      query: str | None = None,
      severity: str | None = None,
  ) -> dict[str, Any]:
      """Get application logs."""
      # URL encode the app_id since it contains slashes
      encoded_app_id = quote(app_id, safe="")
  
      logs = await get_client().get_application_logs(
          project_id, encoded_app_id, from_timestamp, to_timestamp, query, severity
      )
      return {
          "success": True,
          "logs": logs,
      }

• src/mcp_coroot/client.py:386-424 (helper)

  CorootClient helper method that makes the HTTP request to the Coroot API endpoint for application logs.

  async def get_application_logs(
      self,
      project_id: str,
      app_id: str,
      from_timestamp: int | None = None,
      to_timestamp: int | None = None,
      query: str | None = None,
      severity: str | None = None,
  ) -> dict[str, Any]:
      """Get application logs.
  
      Args:
          project_id: Project ID.
          app_id: Application ID.
          from_timestamp: Start timestamp.
          to_timestamp: End timestamp.
          query: Log search query.
          severity: Filter by severity level.
  
      Returns:
          Application logs and patterns.
      """
      params = {}
      if from_timestamp:
          params["from"] = str(from_timestamp)
      if to_timestamp:
          params["to"] = str(to_timestamp)
      if query:
          params["query"] = query
      if severity:
          params["severity"] = severity
  
      response = await self._request(
          "GET",
          f"/api/project/{project_id}/app/{app_id}/logs",
          params=params,
      )
      data: dict[str, Any] = response.json()
      return data

• src/mcp_coroot/server.py:315-328 (schema)

  Input schema and documentation for the get_application_logs tool, defining parameters and their descriptions.

  """Get application logs with pattern analysis.
  
  Retrieves application logs with automatic pattern detection
  and grouping. Supports filtering by time range, search query,
  and severity level.
  
  Args:
      project_id: Project ID
      app_id: Application ID (format: namespace/kind/name)
      from_timestamp: Start timestamp (optional)
      to_timestamp: End timestamp (optional)
      query: Log search query (optional)
      severity: Filter by severity level (optional)
  """