Mc Changelog

io.github.dcd887Published by GitHub account dcd887v1.0.0Updated Oct 24, 2026

查 Minecraft 模组更新日志与版本差异，按版本范围检索

VerifiedSTDIODesktop only

Overview

Mc Changelog's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Mc Changelog in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mc-changelog-mcp

[M8ven Verified]

MCP server for Minecraft modpack changelog generation and version comparison.

Tools

ToolDescription
compare_modpacksCompare two modpack directories and list added/removed/changed mods
generate_changelogGenerate a Markdown-format changelog from a modpack directory
generate_text_summaryGenerate a plain-text summary (suitable for Discord/forum posts)
get_mod_version_infoQuery Modrinth for a mod's version history (requires network)
save_changelogSave a generated changelog to a file
generate_full_changelogGenerate a full changelog including Modrinth version info for each mod

Quick Start

bash
npm installnpm run buildnode dist/index.js

MCP Client Configuration

json
{  "mcpServers": {    "mc-changelog": {      "command": "node",      "args": ["${workspaceFolder}/dist/index.js"]    }  }}

Path note: ${workspaceFolder} resolves to the project root in Trae/VS Code. On other editors use the absolute path: ["C:/path/to/mc-changelog-mcp/dist/index.js"]（把 C:/path/to/ 替换成你的实际路径）。

Configuration

本工具零配置即可用（内置默认值，任何环境开箱即用）。以下项目可通过环境变量或项目根目录 .env 文件覆盖（复制 .env.example 为 .env）：

变量默认值说明
MODRINTH_API_BASEhttps://api.modrinth.com/v2Modrinth API 根地址，支持自建网关/代理
CHANGELOG_USER_AGENTmc-changelog-mcp/1.0请求 User-Agent（Modrinth 要求标明来源）
CHANGELOG_MODS_DIRmods整合包内模组所在子目录名
CHANGELOG_ENRICH_LIMIT5增强信息（enrich）时每个模组返回的版本数量上限

优先级：环境变量 > .env 文件 > 内置默认值。改动后重启 MCP server 生效。

Testing

bash
npm run buildnpm run test:unit   # Unit tests (100% offline)npm test            # Integration tests (requires network for Modrinth API)

Requirements

  • Node.js 18+
  • @modelcontextprotocol/sdk, zod
  • Network access required only for get_mod_version_info and generate_full_changelog

Architecture

mc-changelog-mcp/├── src/│   ├── index.ts                     # MCP server + all tool implementations│   └── changelog-templates.json     # Changelog template definitions├── dist/                            # Compiled JavaScript├── skills/│   └── mc-changelog-helper.md       # Trae Work skill├── __tests__/│   └── unit.test.ts                 # Unit tests (fully offline)├── test.js                          # Integration test runner├── test_logs/                       # Test output logs (gitignored)├── package.json├── tsconfig.json└── .gitignore

License

MIT

Source: README.md at commit dfc144c

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

1
  1. v1.0.0LatestOct 23, 2026

Score

35% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts

    Write a description of at least 40 characters in the registry entry.

  • Logo10 pts
  • Documentation15 pts
  • License10 pts