mc-changelog

Name: mc-changelog
Author: dcd887

本地服务

github.com/dcd887游戏娱乐06 天前更新

代码仓库

关于 mc-changelog

mc-changelog 是面向 Minecraft 整合包维护者的 MCP 服务，可比较模组变更并生成更新日志。它还可查询 Modrinth 版本记录，并输出 Markdown 或纯文本摘要。

主要功能

01比较整合包中的新增、移除和变更模组
02生成 Markdown 更新日志
03生成纯文本摘要
04查询 Modrinth 模组版本记录
05保存日志并生成含版本信息的完整日志

适用场景

01整理整合包版本更新内容
02为 Discord 或论坛准备更新摘要

MCP 相关

该服务向 MCP 客户端提供整合包比较、日志生成、版本查询和文件保存等工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dcd887-mc-changelog": {
      "command": "npx",
      "args": [
        "-y",
        "mc-changelog-mcp"
      ]
    }
  }
}

启动命令npx -y mc-changelog-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmc-changelog-mcp1.0.0stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填	说明
new_pack_dir	string	是	新版本整合包根目录路径
old_pack_dir	string	是	旧版本整合包根目录路径

详细介绍

mc-changelog-mcp

用于生成 Minecraft 整合包更新日志和比较版本的 MCP 服务。

工具

工具	说明
`compare_modpacks`	比较两个整合包目录，并列出新增、移除和更改的模组
`generate_changelog`	根据整合包目录生成 Markdown 格式的更新日志
`generate_text_summary`	生成纯文本摘要（适用于 Discord／论坛帖子）
`get_mod_version_info`	查询 Modrinth 上某个模组的版本历史（需要网络）
`save_changelog`	将生成的更新日志保存到文件
`generate_full_changelog`	生成完整更新日志，包含每个模组的 Modrinth 版本信息

快速开始

npm install
npm run build
node dist/index.js

MCP 客户端配置

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

路径说明： ${workspaceFolder} 在 Trae／VS Code 中会解析为项目根目录。使用其他编辑器时，请填写绝对路径：["C:/path/to/mc-changelog-mcp/dist/index.js"]（将 C:/path/to/ 替换为你的实际路径）。

配置

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

变量	默认值	说明
`MODRINTH_API_BASE`	`https://api.modrinth.com/v2`	Modrinth API 根地址，支持自建网关／代理
`CHANGELOG_USER_AGENT`	`mc-changelog-mcp/1.0`	请求的 User-Agent（Modrinth 要求标明来源）
`CHANGELOG_MODS_DIR`	`mods`	整合包中存放模组的子目录名称
`CHANGELOG_ENRICH_LIMIT`	`5`	增强信息时每个模组返回的版本数量上限

优先级：环境变量 > .env 文件 > 内置默认值。修改后重启 MCP 服务即可生效。

测试

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

要求

Node.js 18+
@modelcontextprotocol/sdk、zod
仅 get_mod_version_info 和 generate_full_changelog 需要网络连接

架构

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