GitHub Releases MCP Server

GitHub Releases MCP Server

GitHub リリース管理のための強力な Model Context Protocol（MCP）ツールキットです。このサーバーは、GitHub リポジトリのリリースへのアクセス、比較、分析に対応する包括的なツールを、豊富な書式設定と詳細な情報とともに提供します。

Features

• 🔍 詳細なリリース情報：特定のリリースの包括的な詳細を取得します
• 📊 バージョン比較：任意の 2 つのバージョン間の変更を比較します
• 📋 リリース一覧：フィルタリングオプションを使って、書式設定されたリリース一覧を取得します
• 🏷️ セマンティックバージョン対応：さまざまなバージョン形式（v1.0.0、@1.0.0、1.0.0）を処理します
• 🎯 プレリリースのフィルタリング：プレリリースを含めるか除外するかを選択できます
• 📝 豊富な書式設定：絵文字を使った出力で読みやすさを向上します
• 🔄 ページネーション対応：リリース数の多いリポジトリも処理します
• 🔒 認証：プライベートリポジトリへのアクセスとレート制限の緩和に、任意で GitHub トークンを使用できます

Configuration

サーバーでは、次の任意の環境変数を受け付けます。

• GITHUB_PERSONAL_ACCESS_TOKEN：GitHub Personal Access Token（任意）。指定すると、API リクエストの認証に使用され、より高いレート制限とプライベートリポジトリへのアクセスが可能になります。

Quick Start

npx を使って、この MCP サーバーを実行できます。

# Using environment variables
GITHUB_PERSONAL_ACCESS_TOKEN=your_token npx @slinerodev/github-releases-mcp

# Or using a .env file
echo "GITHUB_PERSONAL_ACCESS_TOKEN=your_token" > .env
npx @slinerodev/github-releases-mcp

Client Configuration

このサーバーは、さまざまな MCP クライアントで使用できます。クライアントの設定ファイルに、次の設定を追加してください。

• Cursor：~/.cursor/mcp.json
• VS Code：.vscode/settings.json（mcpServers の代わりに mcp.servers を使用してください）
• Claude Desktop：claude_desktop_config.json
• Windsurf：windsurf_config.json

Using Published Version

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

Using Local Development Version

{
  "mcpServers": {
    "github-releases": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "${workspaceRoot}/main.ts"
      ]
    }
  }
}

注意：

• VS Code では、設定内の mcpServers を mcp.servers に置き換えてください。
• プライベートリポジトリにアクセスする場合、またはより高いレート制限が必要な場合は、your_token_here を GitHub Personal Access Token に置き換えてください。

Available Tools

このサーバーは、GitHub リリースを扱うための 3 つの専用ツールを提供します。

1. github_release_info

特定のリリースバージョンの詳細情報を取得します。

const result = await mcp.invoke("github_release_info", {
  owner: "owner-name",
  repo: "repo-name",
  version: "1.0.0" // Supports v1.0.0, @1.0.0, 1.0.0
});

次の用途に最適です。

• 特定のバージョンで何が変更されたかを把握する
• ドキュメント作成
• リリースノートの取得

2. github_releases_compare

2 つのバージョン間の変更を比較します。

const result = await mcp.invoke("github_releases_compare", {
  owner: "owner-name",
  repo: "repo-name",
  fromVersion: "1.0.0",
  toVersion: "2.0.0"
});

次の用途に最適です。

• 変更履歴の生成
• 機能の変遷の把握
• 移行ガイドの作成
• 破壊的変更の分析

3. github_releases_list

フィルタリングオプションを使って、すべてのリリースを一覧表示します。

const result = await mcp.invoke("github_releases_list", {
  owner: "owner-name",
  repo: "repo-name",
  limit: 10, // Optional: limit number of releases
  includePreReleases: false // Optional: include pre-releases
});

次の用途に最適です。

• プロジェクトのリリース履歴の概要確認
• 最新バージョンの検索
• リリース頻度の監視
• プレリリースの追跡

Example Response Format

すべてのツールは、一貫した絵文字付きの形式で応答を返します。

🔖 v1.0.0 (First stable release)
🗓️ 2024-03-15T10:30:00Z
📝 This is the release description...

---

🔖 v0.9.0 (Beta) (Pre-release)
🗓️ 2024-03-01T08:15:00Z
📝 Beta version with new features...

Error Handling

ツールは、さまざまなエラーケースを適切に処理します。

• 無効なリポジトリ名
• 存在しないバージョン
• 無効なバージョン形式
• API のレート制限
• ネットワークの問題
• 認証エラー

各エラーでは、何が問題だったのかを説明する明確なメッセージが返されます。

Development

1. 依存関係をインストールします。

   pnpm install
   

2. サーバーを実行します。

   pnpm start
   

Contributing

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

License

ISC

Author

Sergio Linero