English Français العربية

io.github.dcd887/mc-changelog

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.dcd887/mc-changelog؟

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

كيف أثبّت io.github.dcd887/mc-changelog؟

يعمل على جهازك. في Claude Code: claude mcp add mc-changelog -- npx -y mc-changelog-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.dcd887/mc-changelog إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.dcd887/mc-changelog مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.dcd887/mc-changelog؟

ينشره dcd887. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.