Customable - MCPs

Repositories

49

Projects Packages

17

@customable/changelog-mcp (1.0.5)

Published 2025-10-07 17:11:53 +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@1.0.5

or add it to the package.json file:

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

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

About this package

📝 changelog-mcp

MCP Server for automatic changelog generation from Git history with Conventional Commits support.

Features

Core Features

• 📝 generate_changelog - Generate changelog between tags/commits
• 🏷️ list_tags - List all Git tags
• 📊 analyze_commits - Analyze commits between two references
• 💾 export_changelog - Export in multiple 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
@modelcontextprotocol/sdk	^0.5.0

Development dependencies

ID	Version
@types/node	^18.0.0
typescript	^5.3.0

Keywords

mcp changelog git release-notes

Details

npm

customable-mcp/changelog-mcp

2025-10-07 17:11:53 +02:00

1

Customable Team

Project website

MIT

13 KiB

Assets (1)

changelog-mcp-1.0.5.tgz 13 KiB

Versions (2) View all

2.0.0 2025-10-10

1.0.5 2025-10-07

Issues