Release Intel

release-intel-mcp

基于仓库证据构建发布上下文，而不是从空白提示词开始。此服务会比较两个 Git 引用，并将提交、已合并的拉取请求、关联的问题、标签、变更文件和贡献者整合为结构化的发布记录。

工具页面 · npm · 已列入官方 MCP 注册表

一分钟快速开始

创建一个细粒度 GitHub 令牌，并授予其对要检查的仓库的只读访问权限。当前工具只需要读取仓库内容和拉取请求，无需写入权限。

{
  "mcpServers": {
    "release-intel": {
      "command": "npx",
      "args": ["-y", "@barissozudogru/release-intel-mcp"],
      "env": {
        "GITHUB_TOKEN": "your_read_only_token"
      }
    }
  }
}

然后让客户端查询一个明确的范围：

Use release-intel to build release evidence for owner/repository
from v1.4.0 to v1.5.0. Separate merged PRs from direct commits
and preserve links to the repository record.

令牌会保留在本地服务进程中，且只会发送给 GitHub API。

此仓库的验证结果

对稳定范围 v0.5.1...8a2f350 进行验证后，得到：

Repository:        barissozudogru/release-intel-mcp
Commits:           14
Merged PRs:        1
Files changed:     12
Lines added:       286
Lines deleted:     135
Contributors:      1

响应还包含提交 SHA、消息、作者、拉取请求类别、关联问题，以及在 GitHub 截断证据查询或查询部分失败时发出的警告。

如果这能为你节省时间，欢迎为仓库加星。这有助于其他开发者发现它。

工具

分类依据标签和符合约定的标题信号。仓库标签、问题链接和拉取请求规范会直接影响结果。此服务提供证据和结构；最终的发布说明仍需审核。

发布报告命令

此软件包包含一个终端命令，默认生成 Markdown：

GITHUB_TOKEN=your_read_only_token \
  npx --yes --package @barissozudogru/release-intel-mcp \
  release-intel-report owner/repository v1.4.0 v1.5.0

如果报告将由其他工具使用，请使用 --json：

release-intel-report owner/repository v1.4.0 v1.5.0 --json

GitHub Action

发布版本前，将证据报告附加到工作流摘要中：

name: Release evidence

on:
  workflow_dispatch:
    inputs:
      from_ref:
        required: true
      to_ref:
        required: true

jobs:
  evidence:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
    steps:
      - uses: barissozudogru/[email protected]
        with:
          from-ref: ${{ inputs.from_ref }}
          to-ref: ${{ inputs.to_ref }}
          token: ${{ secrets.GITHUB_TOKEN }}

此 Action 会读取仓库数据，并将 Markdown 写入作业摘要。它不会发布版本，也不会修改仓库内容。

客户端设置

{
  "servers": {
    "release-intel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@barissozudogru/release-intel-mcp"],
      "env": {
        "GITHUB_TOKEN": "your_read_only_token"
      }
    }
  }
}

GITHUB_TOKEN=your_read_only_token \
  npx @barissozudogru/release-intel-mcp --http

docker build -t release-intel-mcp .
docker run -p 3000:3000 \
  -e GITHUB_TOKEN=your_read_only_token \
  release-intel-mcp

本地开发

npm install
npm test
npm run build
GITHUB_TOKEN=your_read_only_token node dist/index.js

要求：Node.js 18 或更高版本。

有关开发工作流，请参阅 CONTRIBUTING.md。

安全与限制

• 使用细粒度的只读令牌，并将其限制为所需的代码库。
• 服务无需获得写入发布、议题或拉取请求的权限。
• GitHub 的比较端点会限制范围特别大的比较。响应会报告是否截断。
• 未关联的直接提交仍会显示，但无法继承拉取请求的元数据。
• 发布类别是有证据支持的启发式分类，并非编辑结论。

许可证

MIT