Customable - MCPs

Repositories

49

Projects Packages

17

@customable/changelog-mcp (2.0.0)

Published 2025-10-10 12:36:46 +02:00 by jack in customable-mcp/changelog-mcp

Installation

Setup this registry in your project .npmrc file:

@customable:registry=

To install the package using npm, run the following command:

npm install @customable/changelog-mcp@2.0.0

or add it to the package.json file:

"@customable/changelog-mcp": "2.0.0"

For more information on the npm registry, see the documentation.

About this package

📝 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

Dependencies

Dependencies

ID	Version
zod	^3.23.8

Development dependencies

ID	Version
@modelcontextprotocol/sdk	^1.20.0
@types/node	^22.0.0
@vitest/coverage-v8	^3.2.4
typescript	^5.5.0
vitest	^3.2.4

Keywords

mcp changelog git release-notes conventional-commits mcp-server

Details

npm

customable-mcp/changelog-mcp

2025-10-10 12:36:46 +02:00

2

Customable Team

Project website

MIT

latest

20 KiB

Assets (1)

changelog-mcp-2.0.0.tgz 20 KiB

Versions (2) View all

2.0.0 2025-10-10

1.0.5 2025-10-07

Issues