Repology MCP Server

<!- - mcp-name: io.github.tschoonj/repology-mcp-server - ->


A Model Context Protocol (MCP) server that provides access to the Repology package repository data through a standardized interface.

# Features

This MCP server exposes the following tools:

• search_projects: Search for projects by name
• get_project: Get detailed information about a specific project
• list_projects: List projects with optional filtering
• get_repository_problems: Get problems reported for repositories
• get_maintainer_problems: Get problems reported for specific maintainers

# Installation

# # Using uv (recommended)

#  Install dependencies
uv sync

#  Install in development mode
uv pip install -e .

# # Using pip

pip install -e .

# Usage

# # As a standalone server

#  Run with stdio transport (for Claude Desktop, etc.)
repology-mcp-server

#  Run with HTTP transport
repology-mcp-server - -transport http - -port 8000

# # With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "repology": {
      "command": "uv",
      "args": ["run", "repology-mcp-server"]
    }
  }
}

Or using the pre-built Docker image:

{
  "mcpServers": {
    "repology": {
      "command": "docker",
      "args": ["run", "-i", "- -rm", "ghcr.io/tschoonj/repology-mcp-server:latest"]
    }
  }
}

# # With VS Code

Add to your VS Code settings (.vscode/settings.json or user settings):

{
  "mcp.servers": {
    "repology": {
      "command": "uv",
      "args": ["run", "repology-mcp-server"]
    }
  }
}

Or using the pre-built Docker image:

{
  "mcp.servers": {
    "repology": {
      "command": "docker",
      "args": ["run", "-i", "- -rm", "ghcr.io/tschoonj/repology-mcp-server:latest"]
    }
  }
}

# # As a development server

#  Run in development mode with MCP inspector
uv run mcp dev src/repology_mcp/server.py

# # Using Docker

# # # Pre-built images from GitHub Container Registry

#  Pull the latest image
docker pull ghcr.io/tschoonj/repology-mcp-server:latest

#  Run with stdio transport
docker run -i - -rm ghcr.io/tschoonj/repology-mcp-server:latest

#  Run with HTTP transport on port 8000
docker run - -rm -p 8000:8000 ghcr.io/tschoonj/repology-mcp-server:latest - -transport http - -port 8000

#  Use a specific version
docker pull ghcr.io/tschoonj/repology-mcp-server:1.0.0
docker run -i - -rm ghcr.io/tschoonj/repology-mcp-server:1.0.0

# # # Local development with Docker

#  Build the Docker image locally
docker build -t repology-mcp-server .

#  Run with stdio transport
docker run -i - -rm repology-mcp-server

#  Run with HTTP transport on port 8000
docker run - -rm -p 8000:8000 repology-mcp-server - -transport http - -port 8000

# Development

# # Setup

#  Clone the repository
git clone <repository-url>
cd repology-mcp-server

#  Install development dependencies
uv sync - -extra dev

# # Running tests

#  Run all tests
uv run pytest

#  Run with coverage
uv run pytest - -cov=repology_mcp - -cov-report=html

#  Run specific test file
uv run pytest tests/test_client.py -v

# # Code formatting

#  Format code
uv run black src tests
uv run isort src tests

#  Type checking
uv run mypy src

# API Reference

# # Tools

# # # search_projects

Search for projects by name substring.

Parameters:

• query (string): Search term to match against project names
• limit (integer, optional): Maximum number of results (default: 10, max: 100)

# # # get_project

Get detailed package information for a specific project.

Parameters:

• project_name (string): Exact name of the project to retrieve

# # # list_projects

List projects with optional filtering.

Parameters:

• start_from (string, optional): Project name to start listing from
• limit (integer, optional): Maximum number of results (default: 10, max: 200)
• maintainer (string, optional): Filter by maintainer email
• category (string, optional): Filter by category
• inrepo (string, optional): Filter by repository presence
• notinrepo (string, optional): Filter by repository absence

# # # get_repository_problems

Get problems reported for a specific repository.

Parameters:

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

# # # get_maintainer_problems

Get problems reported for packages maintained by a specific person.

Parameters:

• maintainer (string): Maintainer email address
• repository (string, optional): Limit to specific repository
• start_from (string, optional): Project name to start from for pagination

# License

MIT License - see LICENSE file for details.

# Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Run the test suite
6. Submit a pull request