changelogai

io.github.ura-tools由 GitHub 帳號 ura-tools 發布v1.1.3更新於 Oct 24, 2026

Generate changelogs and suggest semver bumps from git history

已驗證STDIO僅桌面開發者工具AI 與機器學習

概覽

AI 產生的概覽

根據本機 git 儲存庫的提交歷史產生變更記錄，並建議語意化版本號升級。

可以做什麼
提供兩個工具：changelogai_generate 讀取指定參照之間的 git 歷史，回傳 markdown、JSON 或純文字格式的變更記錄，並可依約定式提交類型分組；changelogai_version_bump 分析提交並建議 major、minor 或 patch 升級。選用的 AI 模式會把技術性提交訊息改寫成面向使用者的發布說明。輸出可寫入檔案或加到既有 CHANGELOG.md 的最前面。
適用情境
適合在準備發布時，讓助理根據提交歷史草擬發布說明或建議版本號升級。適用於遵循約定式提交、並希望在 IDE 或代理工作流程中產生變更記錄的專案。
執行需求
以本機 Node.js 程序執行，通常透過 npx 使用 @ura-dev/changelogai 套件；清單宣告不需要驗證，也沒有環境變數。需要存取本機 git 儲存庫。AI 模式另需透過 ANTHROPIC_API_KEY 設定 Anthropic API 金鑰。
安裝前請注意
AI 模式會把提交訊息傳送到 Anthropic 的 Claude 服務，並需要 ANTHROPIC_API_KEY 密鑰；README 說明該模式依每次產生計費。使用 --output 與 --prepend 會修改 CHANGELOG.md 等檔案，提交前請先檢查變更。此伺服器會讀取所指定儲存庫路徑的 git 歷史。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 changelogai，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

changelogai

Generate professional changelogs from your git history — instantly.

Works out of the box with conventional commits. Optional AI mode uses Claude to rewrite technical commit messages into user-facing release notes.

Install

bash
npm install -g @ura-dev/changelogai

Quick Start

bash
# Run without installingnpx @ura-dev/changelogai
# Generate changelog since last tagchangelogai
# Grouped by categorychangelogai --group
# AI-enhanced (requires ANTHROPIC_API_KEY)changelogai --ai --group
# Write to filechangelogai --group --output CHANGELOG.md
# Prepend new release to existing changelogchangelogai --group --output CHANGELOG.md --prepend
# JSON output for CI/CDchangelogai --format json
# Suggest semver bumpchangelogai --version-bump

Features

  • Zero config — auto-detects latest tag, parses conventional commits
  • Smart grouping — categorizes commits into Features, Bug Fixes, Performance, etc.
  • AI mode — rewrites commit messages into clear, user-facing descriptions using Claude
  • Multiple formats — Markdown, JSON, plain text
  • Version bump suggestion — analyzes changes and suggests major/minor/patch
  • Prepend mode — add new releases to the top of existing CHANGELOG.md
  • No dependencies — pure Node.js, works everywhere

Options

FlagDescriptionDefault
--from <ref>Start ref (tag/commit)Latest tag
--to <ref>End refHEAD
--output <file>Write to filestdout
--format <fmt>markdown, json, plainmarkdown
--groupGroup by commit typefalse
--aiAI-enhanced descriptionsfalse
--model <model>Claude model for AI modeclaude-haiku-4-5-20251001
--prependPrepend to existing filefalse
--version-bumpSuggest semver bumpfalse
--repo <path>Git repo path.
--max-commits <n>Max commits to process500

MCP Server

changelogai includes a Model Context Protocol server for AI agents and IDE integrations (Claude Desktop, Cursor, VS Code, etc.).

json
{  "mcpServers": {    "changelogai": {      "command": "npx",      "args": ["-y", "-p", "@ura-dev/changelogai", "changelogai-mcp"]    }  }}

Or if installed globally:

json
{  "mcpServers": {    "changelogai": {      "command": "changelogai-mcp"    }  }}

Available Tools

ToolDescription
changelogai_generateGenerate a changelog from git history. Returns markdown, JSON, or plain text.
changelogai_version_bumpAnalyze git commits and suggest next semver bump (major/minor/patch).

AI Mode

Set your Anthropic API key:

bash
export ANTHROPIC_API_KEY=sk-ant-...

Then run with --ai:

bash
changelogai --ai --group --output CHANGELOG.md

AI mode rewrites technical commit messages into clear, user-facing release notes. Uses Claude Haiku by default (fast and cheap — ~$0.001 per changelog).

License

MIT

來源：README.md，提交 8c9e59c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分