Release Notes Server

リリースノートサーバー

GitHub リポジトリから美しいリリースノートを生成する MCP サーバーです。コミットを効率的に取得し、種類ごとに整理して、すっきりと読みやすい形式で表示します。

機能

• 🎯 日付または SHA によるスマートなコミットのフィルタリング
• 📊 コミットを種類（機能、修正など）ごとにグループ化
• 🔍 コミットに PR データを追加
• 📈 詳細な統計情報を含める
• 🎨 絵文字を使ったすっきりとした Markdown の書式
• ⚡ GitHub の since パラメーターを使った効率的な API の利用

インストール

npm install
npm run build

使用方法

このサーバーを MCP の設定に追加します。

{
  "mcpServers": {
    "release-notes": {
      "command": "node",
      "args": ["/path/to/release-notes-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

利用可能なツール

generate_release_notes

GitHub リポジトリのリリースノートを生成します。

パラメーター：

{
  "owner": string,           // Repository owner
  "repo": string,           // Repository name
  "commitRange": {
    "fromCommit"?: string,  // Starting commit SHA
    "toCommit"?: string    // Ending commit SHA
  },
  "format": {
    "type": "markdown",     // Output format
    "groupBy": "type",      // How to group commits
    "includeStats": boolean // Include commit statistics
  }
}

例：

const result = await use_mcp_tool({
  server_name: "release-notes",
  tool_name: "generate_release_notes",
  arguments: {
    owner: "owner",
    repo: "repo",
    commitRange: {
      fromCommit: "abc123" // Get commits from this SHA
    },
    format: {
      type: "markdown",
      groupBy: "type",
      includeStats: true
    }
  }
});

出力形式

生成されるリリースノートには、次の内容が含まれます。

1. 生成日と統計情報を含むヘッダー

2. コミットの種類ごとにグループ化されたセクション：

   • 🚀 機能
   • 🐛 修正
   • 📚 ドキュメント
   • ⚡ パフォーマンス
   • ♻️ リファクタリング
   • 🧪 テスト
   • 🏗️ ビルド
   • 🔧 その他

3. 次の項目を含む詳細な統計情報：

   • コミットの合計数
   • 破壊的変更
   • 種類ごとのコミット数
   • 作成者ごとのコミット数

環境変数

• GITHUB_TOKEN：リポジトリへのアクセス権を持つ GitHub の個人アクセストークン

実装の詳細

このサーバーは、次の方法でコミットを効率的に取得します。

1. 可能な場合は GitHub の since パラメーターを使用して、API 呼び出しを削減します
2. 必要に応じて SHA ベースのフィルタリングに切り替えます
3. ページネーションを適切に処理します
4. リリースノートが新しい順になるようにします
5. 利用可能な場合は、コミットに PR データを追加します

ライセンス

MIT