Repology MCP Server

Instructions

Args:
    repository: Repository name (e.g., "freebsd", "debian")
    start_from: Project name to start from for pagination

Returns:
    JSON formatted list of problems for the repository

Implementation Reference

• src/repology_mcp/server.py:269-304 (handler)

  The main @mcp.tool()-decorated handler function that implements the core logic for the 'get_repository_problems' tool. It fetches problems from the Repology client, handles empty results, errors, and serializes to JSON.

  @mcp.tool()
  async def get_repository_problems(
      repository: str,
      start_from: Optional[str] = None,
      ctx: Context[ServerSession, AppContext] = None,
  ) -> str:
      """Get problems reported for a specific repository.
  
      Args:
          repository: Repository name (e.g., "freebsd", "debian")
          start_from: Project name to start from for pagination
  
      Returns:
          JSON formatted list of problems for the repository
      """
      try:
          client = ctx.request_context.lifespan_context.repology_client
          problems = await client.get_repository_problems(
              repository=repository, start_from=start_from
          )
  
          if not problems:
              return json.dumps(
                  {"message": f"No problems found for repository '{repository}'"}
              )
  
          return _problems_to_json(problems)
  
      except RepologyNotFoundError:
          return json.dumps({"error": f"Repository '{repository}' not found"})
      except RepologyAPIError as e:
          await ctx.error(f"Repology API error: {e}")
          return json.dumps({"error": str(e)})
      except Exception as e:
          await ctx.error(f"Unexpected error getting repository problems: {e}")
          return json.dumps({"error": f"Unexpected error: {e}"})

• src/repology_mcp/models.py:36-46 (schema)

  Pydantic model defining the structure and validation for Problem objects returned by the tool.

  class Problem(BaseModel):
      """A problem reported for a package."""
  
      type: str = Field(description="Problem type")
      data: Dict[str, Any] = Field(description="Additional problem details")
      project_name: str = Field(description="Repology project name")
      version: str = Field(description="Package version")
      srcname: Optional[str] = Field(None, description="Source package name")
      binname: Optional[str] = Field(None, description="Binary package name")
      rawversion: Optional[str] = Field(None, description="Raw package version")

• src/repology_mcp/server.py:45-47 (helper)

  Helper function used by the handler to serialize the list of Problem objects to a formatted JSON string.

  def _problems_to_json(problems: List[Problem]) -> str:
      """Convert problems list to formatted JSON string."""
      return json.dumps([prob.model_dump() for prob in problems], indent=2)

• src/repology_mcp/client.py:285-319 (helper)

  RepologyClient method that performs the actual HTTP API request to fetch repository problems and validates them using the Problem model.

  async def get_repository_problems(
      self, repository: str, start_from: Optional[str] = None
  ) -> ProblemsData:
      """Get problems for a specific repository.
  
      Args:
          repository: Repository name
          start_from: Project name to start from for pagination
  
      Returns:
          List of problems
      """
      endpoint = f"repository/{quote(repository)}/problems"
      params = {}
      if start_from:
          params["start"] = start_from
  
      try:
          data = await self._make_request(endpoint, params)
  
          if not isinstance(data, list):
              raise RepologyAPIError(f"Expected list, got {type(data)}")
  
          problems = []
          for item in data:
              try:
                  problems.append(Problem.model_validate(item))
              except ValidationError as e:
                  print(f"Warning: Failed to validate problem data: {e}")
                  continue
  
          return problems
  
      except Exception as e:
          raise RepologyAPIError(f"Failed to get repository problems: {e}")