GitHub Releases MCP Server

by SLineroDev

3 269 downloads Not rated yet

About

A powerful Model Context Protocol (MCP) toolkit for GitHub releases management. This server provides comprehensive tools for accessing, comparing, and analyzing GitHub repository releases with rich formatting and detailed information.

Explore

- 🔍 Detailed Release Information: Get comprehensive details about specific releases
- 📊 Version Comparison: Compare changes between any two versions
- 📋 Release Listing: Get formatted lists of releases with filtering options
- 🏷️ Semantic Version Support: Handles various version formats (v1.0.0, @1.0.0, 1.0.0)
- 🎯 Pre-release Filtering: Option to include or exclude pre-releases
- 📝 Rich Formatting: Emoji-enhanced output for better readability
- 🔄 Pagination Support: Handles repositories with many releases
- 🔒 Authentication: Optional GitHub token support for private repositories and extended rate limit

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name GitHub Releases MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The server accepts the following optional environment variables:

- GITHUB_PERSONAL_ACCESS_TOKEN: GitHub Personal Access Token (optional). If provided, it will be used to authenticate API requests, allowing for higher rate limits and access to private repositories.

GITHUB_PERSONAL_ACCESS_TOKEN=your_token npx @slinerodev/github-releases-mcp

The server can be used with various MCP clients. Add the following configuration to your client's config file:

- Cursor: ~/.cursor/mcp.json
- VS Code: .vscode/settings.json (use mcp.servers instead of mcpServers)
- Claude Desktop: claude_desktop_config.json
- Windsurf: windsurf_config.json

github_release_info

Get detailed information about a specific GitHub release version. Supports semantic versioning formats (v1.0.0, @1.0.0, 1.0.0) and returns comprehensive release details including tag name, release title, publication date, and full release notes. Perfect for understanding what changed in a specific version or for documentation purposes.

github_releases_compare

Compare changes between two GitHub release versions. Ideal for understanding what changed between versions, generating changelogs, or migration guides. Returns a chronological list of all releases between the two versions with their full release notes, making it perfect for analyzing the evolution of features, bug fixes, and breaking changes. Supports semantic versioning formats (v1.0.0, @1.0.0, 1.0.0).

github_releases_list

List all GitHub releases for a repository with rich formatting and comprehensive details. Returns releases in chronological order with emojis for better readability (🔖 for versions, 🗓️ for dates, 📝 for descriptions). Perfect for getting an overview of a project's release history, finding the latest version, or monitoring release frequency. Supports pagination and filtering of pre-releases.

github_org_packages

List all packages for a GitHub organization. Returns detailed information about each package including its name, type, visibility, and repository details. Perfect for discovering available packages and their metadata in an organization.

github_repo_readme

Fetch the README file for a GitHub repository and return its plain text content. Useful for discovering package names and documentation in monorepos.

The server provides three specialized tools for working with GitHub releases:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "github releases mcp server": {
            "github-releases-mcp": {
                "command": "npx",
                "args": [
                    "@slinerodev/github-releases-mcp"
                ],
                "env": {
                    "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token"
                }
            }
        }
    }
}

McpServers

{
    "github-releases-mcp": {
        "command": "npx",
        "args": [
            "@slinerodev/github-releases-mcp"
        ],
        "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token"
        }
    }
}

A powerful Model Context Protocol (MCP) toolkit for GitHub releases management. This server provides comprehensive tools for accessing, comparing, and analyzing GitHub repository releases with rich formatting and detailed information.

Features

- 🔍 Detailed Release Information: Get comprehensive details about specific releases
- 📊 Version Comparison: Compare changes between any two versions
- 📋 Release Listing: Get formatted lists of releases with filtering options
- 🏷️ Semantic Version Support: Handles various version formats (v1.0.0, @1.0.0, 1.0.0)
- 🎯 Pre-release Filtering: Option to include or exclude pre-releases
- 📝 Rich Formatting: Emoji-enhanced output for better readability
- 🔄 Pagination Support: Handles repositories with many releases
- 🔒 Authentication: Optional GitHub token support for private repositories and extended rate limit

Configuration

The server accepts the following optional environment variables:

- GITHUB_PERSONAL_ACCESS_TOKEN: GitHub Personal Access Token (optional). If provided, it will be used to authenticate API requests, allowing for higher rate limits and access to private repositories.

Quick Start

You can run this MCP server using npx:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.