Github Releases MCP

🚀 GitHub で MCP サーバーを公開

強力なモデルコンテキストプロトコル（MCP）ツールキットで、GitHub の公開を管理します。このサーバーは、GitHub リポジトリの公開に関する豊富な形式と詳細情報を持つ、アクセス、比較、分析のための包括的なツールを提供します。

✨ 主な機能

• 🔍 詳細な公開情報：特定のバージョンの包括的な詳細を取得します。
• 📊 バージョン比較：2 つのバージョン間の変更を比較します。
• 📋 公開リスト：フィルタオプション付きのフォーマットされた公開リストを取得します。
• 🏷️ セマンティックバージョンサポート：さまざまなバージョン形式（v1.0.0、@1.0.0、1.0.0）を処理します。
• 🎯 プレリリースフィルタリング：プレリリースバージョンを含めるか除外するかを選択します。
• 📝 豊富な形式：絵文字付きの出力で、読みやすさを向上させます。
• 🔄 ページングサポート：多数の公開を持つリポジトリを処理します。
• 🔒 認証：オプションの GitHub トークンサポートで、プライベートリポジトリとより高いレート制限を利用できます。

📦 インストール

サーバーは以下のオプションの環境変数を受け付けます：

• GITHUB_PERSONAL_ACCESS_TOKEN：GitHub の個人用アクセストークン（オプション）。提供された場合、API リクエストの認証に使用され、より高いレート制限とプライベートリポジトリへのアクセスが可能になります。

🚀 クイックスタート

npx を使用してこの MCP サーバーを実行できます：

# 環境変数を使用する場合
GITHUB_PERSONAL_ACCESS_TOKEN=your_token npx @slinerodev/github-releases-mcp

# または.env ファイルを使用する場合
echo "GITHUB_PERSONAL_ACCESS_TOKEN=your_token" > .env
npx @slinerodev/github-releases-mcp

💻 使用例

クライアント設定

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

• カーソル：~/.cursor/mcp.json
• VS Code：.vscode/settings.json（mcp.servers を mcpServers ではなく使用）
• Claude Desktop：claude_desktop_config.json
• IntelliJ：idea.properties

基本的な使用法

VS Code の場合

{
  "mcp.servers": [
    {
      "name": "GitHub Releases",
      "type": "github-releases",
      "config": {
        "owner": "your-owner",
        "repo": "your-repo",
        "token": "your-token"
      }
    }
  ]
}

IntelliJ の場合

mcp.servers=github-releases
github-releases.owner=your-owner
github-releases.repo=your-repo
github-releases.token=your-token

高度な使用法

1. 公開情報の取得

指定されたリポジトリのすべての公開情報を取得します：

mcp github-releases --owner your-owner --repo your-repo --token your-token

特定のバージョンの詳細情報をリストします：

mcp github-releases --owner your-owner --repo your-repo --version 1.0.0 --token your-token

2. 公開の作成

ファイルから新しい公開を作成します：

mcp github-releases create \
--owner your-owner \
--repo your-repo \
--token your-token \
--name "New Version" \
--tag v1.0.0 \
--description "# New Version\n## Changes"

3. 公開の削除

指定されたバージョンの公開を削除します：

mcp github-releases delete \
--owner your-owner \
--repo your-repo \
--token your-token \
--version 1.0.0

📚 ドキュメント

エラー処理

ツールはさまざまなエラー状況を適切に処理します：

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

各エラーは、何が問題であるかを説明する明確なメッセージを返します。

開発

1. 依存関係のインストール：

pnpm install

2. サーバーの実行：

pnpm start

貢献

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

📄 ライセンス

ISC

作者

Sergio Linero