MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:152-159 (handler)

  Main MCP tool handler for 'list_projects'. Decorated with @mcp.tool() for registration and executes the tool logic by calling the impl helper.
  @mcp.tool() async def list_projects() -> dict[str, Any]: """List all accessible projects. Returns a list of all projects that the authenticated user has access to. Each project includes its ID and name. """ return await list_projects_impl() # type: ignore[no-any-return]
• src/mcp_coroot/server.py:141-149 (helper)

  Helper implementation that fetches projects via CorootClient and formats the success response with count and projects list.
  @handle_errors async def list_projects_impl() -> dict[str, Any]: """List all accessible projects.""" projects = await get_client().list_projects() return { "success": True, "count": len(projects), "projects": projects, }
• src/mcp_coroot/client.py:290-300 (helper)

  CorootClient method that implements the actual API call to retrieve projects from the /api/user endpoint.
  async def list_projects(self) -> list[dict[str, Any]]: """List all accessible projects. Returns: List of project dictionaries. """ # Get user info which includes projects list user_response = await self._request("GET", "/api/user") user_data: dict[str, Any] = user_response.json() projects: list[dict[str, Any]] = user_data.get("projects", []) return projects
• src/mcp_coroot/server.py:93-113 (helper)

  Lazy client factory used by tool helpers to get the shared CorootClient instance.
  def get_client() -> CorootClient: """Get or create the client instance. Raises: ValueError: If no credentials are configured. """ global _client if _client is None: try: _client = CorootClient() except ValueError as e: # Re-raise with more context raise ValueError( "Coroot credentials not configured. " "Please set COROOT_BASE_URL and either:\n" " - COROOT_USERNAME and COROOT_PASSWORD for automatic login\n" " - COROOT_SESSION_COOKIE for direct authentication\n" " - COROOT_API_KEY for data ingestion endpoints" ) from e return _client