Github Releases MCP

🚀 GitHub 發佈 MCP 服務器

這是一個功能強大的模型上下文協議（MCP）工具包，用於管理 GitHub 發佈。藉助此服務器，你可以全面訪問、比較和分析 GitHub 存儲庫發佈，獲取豐富格式和詳細信息。

🚀 快速開始

你可以使用 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

✨ 主要特性

• 🔍 詳細的發佈信息：獲取特定版本的全面細節
• 📊 版本比較：比較兩個版本之間的更改
• 📋 發佈列表：獲得格式化的發佈列表，帶過濾選項
• 🏷️ 語義化版本支持：處理各種版本格式（v1.0.0、@1.0.0、1.0.0）
• 🎯 預發佈篩選：選擇包含或排除預發佈版本
• 📝 豐富格式：帶有表情符號的輸出，提高可讀性
• 🔄 分頁支持：處理具有大量發佈的存儲庫
• 🔒 身份驗證：可選 GitHub 令牌支持，用於私有存儲庫和更高的速率限制

📦 安裝指南

配置

服務器接受以下可選環境變量：

• GITHUB_PERSONAL_ACCESS_TOKEN：GitHub 個人訪問令牌（可選）。如果提供，則會用於認證 API 請求，允許更高的速率限制和對私有存儲庫的訪問。

💻 使用示例

客戶端配置

服務器可以與各種 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

可用工具

基礎用法

獲取指定存儲庫的所有發佈信息：

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

從文件創建新發布：

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"

刪除指定版本的發佈：

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