customable-mcp/changelog-mcp

Fork 0

MCP Server for changelog generation from Git commits - conventional commits parsing, multi-format output (Markdown, HTML, JSON), and version management

changelog conventional-commits git mcp release-notes typescript

Find a file

Jonas Hanisch d113c6f934 All checks were successful Publish Package / publish (push) Successful in 26s Details Merge develop → main: Release v2.0.0 Complete refactor with comprehensive improvements: ✨ New Features: - 27 comprehensive unit tests with Vitest - 100% TypeScript type safety - Complete JSDoc documentation 🏗️ Architecture: - Modular structure (types, tool-definitions, handlers, changelog-service, index) - Type-safe interfaces: Commit, ChangelogSection, Changelog, ToolArguments - index.ts: 197 → 80 lines (59% reduction) 🧪 Testing: - Type validation tests - Tool definition validation tests - Full test coverage 📦 Dependencies: - MCP SDK upgraded to 1.20.0 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>		2025-10-10 12:36:02 +02:00
.forgejo/workflows	fix: use direct authentication token in CI workflow (v1.0.5)	2025-10-07 17:09:46 +02:00
src	Refactor to v2.0.0: Modular architecture with comprehensive testing	2025-10-10 12:35:55 +02:00
.gitignore	fix: registry configuration for scope-based installation (v1.0.1)	2025-10-07 12:33:52 +02:00
CHANGELOG.md	Refactor to v2.0.0: Modular architecture with comprehensive testing	2025-10-10 12:35:55 +02:00
package-lock.json	Refactor to v2.0.0: Modular architecture with comprehensive testing	2025-10-10 12:35:55 +02:00
package.json	Refactor to v2.0.0: Modular architecture with comprehensive testing	2025-10-10 12:35:55 +02:00
README.md	Refactor to v2.0.0: Modular architecture with comprehensive testing	2025-10-10 12:35:55 +02:00
tsconfig.json	Implement Changelog MCP Server with Git history parsing	2025-10-07 11:07:41 +02:00
vitest.config.ts	Refactor to v2.0.0: Modular architecture with comprehensive testing	2025-10-10 12:35:55 +02:00

README.md

📝 changelog-mcp

MCP Server for automatic changelog generation from Git history - featuring conventional commits parsing, multi-format output, and comprehensive testing.

What's New in v2.0.0

✨ Complete Refactor - Modular architecture with 59% code reduction 🧪 27 Unit Tests - Full test coverage with Vitest 🎯 100% Type Safety - Eliminated all any types 📚 Complete JSDoc - Comprehensive API documentation 📦 MCP SDK 1.20.0 - Latest SDK with improved capabilities

Features

Core Features

🏷️ list_tags - List all Git tags in a repository, sorted by version
📊 get_commits - Get commits between two Git references (tags, branches, or commit hashes)
📈 analyze_commits - Analyze and categorize commits using Conventional Commits format
📝 generate_changelog - Generate formatted changelog with support for multiple output formats (Markdown, HTML, JSON)

Advanced Features

🏷️ Automatic categorization (features, bugfixes, breaking changes)
📄 Multiple output formats (Markdown, HTML, JSON)
🎨 Customizable templates
🔗 Issue/PR linking (GitHub, GitLab, Forgejo)
📋 Conventional Commits parsing
🎯 Scope-based grouping
📈 Contribution statistics

Installation

npm install
npm run build

Configuration

Optional environment variables:

REPO_PATH - Default repository path (default: current directory)
ISSUE_BASE_URL - Base URL for issue linking (e.g., https://github.com/owner/repo/issues/)

Usage

npm start

Examples

Generate changelog

{
  "tool": "generate_changelog",
  "arguments": {
    "repoPath": "/path/to/repo",
    "fromRef": "v1.0.0",
    "toRef": "v2.0.0",
    "format": "markdown"
  }
}

Analyze commits

{
  "tool": "analyze_commits",
  "arguments": {
    "repoPath": "/path/to/repo",
    "fromRef": "v1.0.0",
    "toRef": "HEAD"
  }
}

Conventional Commits

This tool supports the Conventional Commits specification:

feat: - New features
fix: - Bug fixes
docs: - Documentation changes
style: - Code style changes
refactor: - Code refactoring
perf: - Performance improvements
test: - Test changes
chore: - Maintenance tasks
BREAKING CHANGE: - Breaking changes

License

MIT