🚀 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