MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:1774-1781 (handler)

  The primary handler function for the 'health_check' MCP tool. The @mcp.tool() decorator registers this function as an MCP tool with the name 'health_check'. It delegates to the helper implementation.

  @mcp.tool()
  async def health_check() -> dict[str, Any]:
      """Check if Coroot server is healthy.
  
      Performs a simple health check to verify that the Coroot
      server is running and accessible.
      """
      return await health_check_impl()  # type: ignore[no-any-return]

• src/mcp_coroot/server.py:1761-1772 (helper)

  Helper implementation that calls the CorootClient's health_check method, handles the response, and formats it for the MCP tool.

  @handle_errors
  async def health_check_impl() -> dict[str, Any]:
      """Check Coroot server health."""
      is_healthy = await get_client().health_check()
      return {
          "success": True,
          "healthy": is_healthy,
          "message": "Coroot server is healthy"
          if is_healthy
          else "Coroot server is not responding",
      }

• src/mcp_coroot/client.py:1488-1498 (helper)

  Core implementation in CorootClient that performs the HTTP GET request to the Coroot server's /health endpoint and checks the status code.

  async def health_check(self) -> bool:
      """Check if Coroot server is healthy.
  
      Returns:
          True if healthy, False otherwise.
      """
      try:
          response = await self._request("GET", "/health")
          return response.status_code == 200
      except Exception:
          return False