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()