Release Intel

release-intel-mcp

空のプロンプトではなく、リポジトリの証拠からリリースのコンテキストを構築します。このサーバーは2つの Git 参照を比較し、コミット、マージ済みのプルリクエスト、関連する issue、ラベル、変更ファイル、コントリビューターを関連付けて、構造化されたリリースレコードにまとめます。

ツールページ · npm · 公式の MCP Registry に掲載されています

1分で開始

調査するリポジトリに対して読み取り専用アクセス権を持つ、きめ細かなアクセス許可の 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、メッセージ、作成者、プルリクエストのカテゴリ、関連する issue も含まれます。また、GitHub によって証拠の検索結果が切り詰められた場合や、一部の検索に失敗した場合は警告が含まれます。

時間の節約に役立った場合は、リポジトリにスターを付けることをご検討ください。他の開発者がこのツールを見つけやすくなります。

ツール

分類にはラベルとタイトルに含まれる規約上のシグナルを使用します。リポジトリのラベル、issue のリンク、プルリクエストの整備状況は、結果に直接影響します。サーバーは証拠と構造を提供しますが、最終的なリリースの説明文は引き続き確認が必要です。

リリースレポートコマンド

このパッケージには、デフォルトで 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