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 分