io.github.dcd887/mc-changelog

Official registry Other

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mc-changelog-mcp
Claude Code
claude mcp add mc-changelog -- npx -y mc-changelog-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "mc-changelog": {
            "command": "npx",
            "args": [
                "-y",
                "mc-changelog-mcp@1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mc-changelog-mcp
  2. Tools
  3. Quick Start
  4. MCP Client Configuration
  5. Configuration
  6. Testing
  7. Requirements
  8. Architecture
  9. License

mc-changelog-mcp

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

npm install
npm run build
node dist/index.js

MCP Client Configuration

{
  "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

npm run build
npm 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

Frequently asked questions

What is io.github.dcd887/mc-changelog?

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

How do I install io.github.dcd887/mc-changelog?

It runs on your machine. In Claude Code: claude mcp add mc-changelog -- npx -y mc-changelog-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.dcd887/mc-changelog need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.dcd887/mc-changelog open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.dcd887/mc-changelog?

It is published by dcd887. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.