release-notes-generator-iris

Iris MCP Server automatically generates release notes for a Git repository by analyzing tag differences. It outputs structured notes in Markdown format and saves them to a .iris directory, with categorization for new features, improvements, bug fixes, and breaking changes. You interact with the server through the MCP client by invoking the generate_release_note tool exposed by the iris-mcp-server package. To use it, provide a startTag and endTag to define the range of tags to compare, a title for the release, and lists for features, improvements, bugfixes, and breaking changes. The tool will produce a Markdown-formatted release note and store the result in the repository’s .iris folder for versioned tracking. Typical usage targets the common release flow between two tags and can be integrated into CI pipelines to auto-generate notes on new releases.

Prerequisites:

• Node.js and npm installed on your machine or CI environment
• Git repository with tagged releases

1. Install the Iris MCP Server package globally or within your project:

   npm install iris-mcp-server

2. Verify the installation by listing the installed package or running a quick help command (adjust as needed based on your setup):

   npx iris-mcp-server --help

3. Ensure your project repository is initialized as a Git repository with tags for release notes generation. For CI environments, configure the runner to have access to the repository and required permissions to read tags and write the .iris directory.

4. If you are using the MCP client to invoke tools, ensure it can reach the Iris MCP Server (via the command defined in mcp_config).

Tips and common issues:

• Ensure the startTag and endTag exist and are in the correct chronological order (startTag should be older than endTag).
• The output is Markdown and saved under a .iris directory; ensure write permissions to the repository.
• If you modify the release notes template, the notes generator will reflect new sections or formatting on subsequent runs.
• If running in CI, consider caching the .iris output between runs if the repository layout requires it.
• The npm package name is iris-mcp-server; use npx iris-mcp-server to run the server as shown in examples.