Mc Changelog
MCP server that builds changelogs and compares Minecraft modpack versions
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- today
Similar MCP servers
About Mc Changelog
Mc Changelog is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The README describes this as an MCP server for generating changelogs from Minecraft modpack directories and comparing two versions of a pack. It reports which mods were added, removed or changed, and can output the result as Markdown or as plain text suited to Discord and forum posts.
Optional tools query the Modrinth API for each mod's version history, so a changelog can include upstream version details. The README notes that only these two network-dependent tools need internet access; the rest run offline. Settings such as the Modrinth API base URL, the mods subfolder and the number of versions returned can be changed through environment variables or a .env file.
It suits modpack authors and server maintainers who publish release notes and want to generate them from the pack folder instead of writing them by hand. The registry entry describes it as a way to look up mod update logs and version differences by version range.
Install
Run in a terminal
claude mcp add mc-changelog -- npx -y mc-changelog-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mc-changelog": {
"command": "npx",
"args": [
"-y",
"mc-changelog-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mc-changelog": {
"command": "npx",
"args": [
"-y",
"mc-changelog-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mc-changelog": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mc-changelog-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mc-changelog": {
"command": "npx",
"args": [
"-y",
"mc-changelog-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mc-changelog": {
"command": "npx",
"args": [
"-y",
"mc-changelog-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- compare_modpacks
- Compare two modpack directories and list added/removed/changed mods
- generate_changelog
- Generate a Markdown-format changelog from a modpack directory
- generate_text_summary
- Generate a plain-text summary (suitable for Discord/forum posts)
- get_mod_version_info
- Query Modrinth for a mod's version history (requires network)
- save_changelog
- Save a generated changelog to a file
- generate_full_changelog
- Generate a full changelog including Modrinth version info for each mod
What it does
- Modpack version comparison
- Compares two modpack directories and lists mods that were added, removed or changed.
- Markdown changelog generation
- Produces a Markdown changelog from a modpack folder.
- Plain-text summaries
- Creates a plain-text summary intended for Discord or forum posts.
- Modrinth version history
- Queries Modrinth for a mod's version history when network access is available.
- Saved changelog files
- Writes a generated changelog to a file.
- Offline by default
- Only the Modrinth-dependent tools require network access, according to the README.
Good for
- Writing release notes when updating a Minecraft modpack
- Showing players what changed between two pack versions
- Posting a short update summary to a Discord server or forum
- Checking a mod's available versions on Modrinth before upgrading
Pricing
Open source
Free and MIT licensed, self-hosted via npm.
Mc Changelog FAQ
Which tools need an internet connection?
The README says get_mod_version_info and generate_full_changelog require network access to Modrinth. The other tools work offline.
How is it installed and run?
The README gives the steps npm install, npm run build and node dist/index.js, and shows an MCP client configuration that launches dist/index.js with node.
Does it need configuration?
The README says it works with built-in defaults. Environment variables or a .env file can override the Modrinth API base, user agent, mods directory and enrichment limit.
Is Mc Changelog free?
Yes. Mc Changelog is open source, so you can use and self-host it for free.
How do I add Mc Changelog to Claude Code?
Run this command in your terminal: claude mcp add mc-changelog -- npx -y mc-changelog-mcp
What are the best alternatives to Mc Changelog?
The closest alternatives to Mc Changelog are Mc Pack Builder, Mc Rp Assistant, MCP Registry Monitor, Git Diff Mcp and MCP Morning.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.