Releases

You can run the MCP Releases Server to fetch the latest GitHub release information for repositories and the latest PyPI package versions. It automatically falls back to PyPI when a GitHub release isn’t available, and you can configure aliases for common repositories to simplify lookups.

How to use

Use an MCP client to query the server for the latest stable release information from GitHub or PyPI. If a GitHub release exists for a repository, you’ll get that version; if not, the server will automatically check PyPI (when a PyPI package is configured for that repo). You can also use the PyPI lookup function directly to retrieve the latest stable version and metadata for any Python package.

How to install

Prerequisites you need before starting: Python runtime and an MCP client environment. You can run the server with Docker or run it locally via the Python/UV runtime.

Option 1: Run with Docker. Build and start the server using Docker Compose.

docker-compose up --build

Option 2: Run locally with UVicorn. Start the server directly from your development environment.

uv run uvicorn server:app --host 0.0.0.0 --port 8000

Additional notes

Environment configuration is optional but recommended. Create a project root .env file to provide a GitHub token and avoid API rate limits. The token is not required for the server to run, but it improves rate limits when querying GitHub.

export GITHUB_TOKEN="github_pat_TOKEN"

Configure repository aliases and PyPI package mappings to enable convenient lookups. Example configuration structure for repo aliases and PyPI package fallbacks is shown below.

{
  "fastapi": {
    "repo": "tiangolo/fastapi",
    "aliases": ["FastAPI"],
    "pypi_package": "fastapi"
  },
  "nomad": {
    "repo": "hashicorp/nomad",
    "aliases": ["Nomad"]
  }
}

Available tools

get_latest_release

Returns the latest stable GitHub release for a given repository, automatically falling back to a PyPI lookup when a GitHub release is not available.

get_pypi_version

Directly query PyPI for the latest stable production version of a Python package and include package metadata.