MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:502-519 (handler)

  Primary MCP tool handler function registered with @mcp.tool(). Handles tool execution, input validation via type hints/docstring, error handling, and delegates to the implementation helper which calls the Coroot client.

  @mcp.tool()
  async def get_deployments_overview(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get deployment tracking overview.
  
      Returns information about recent deployments:
      - Deployment timeline
      - Success/failure rates
      - Rollback history
      - Impact on application performance
  
      Args:
          project_id: Project ID
          query: Search/filter query (optional)
      """
      return await get_deployments_overview_impl(project_id, query)  # type: ignore[no-any-return]

• src/mcp_coroot/server.py:489-500 (helper)

  Internal helper implementation that calls the CorootClient to fetch deployments overview data and formats the response.

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

• src/mcp_coroot/client.py:546-570 (helper)

  CorootClient utility method that makes the HTTP API request to retrieve deployments overview from the Coroot server.

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

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

  FastMCP decorator that registers the get_deployments_overview tool with the MCP server, auto-generating schema from signature and docstring.

  @mcp.tool()