mc-changelog

mc-changelog-mcp

Minecraft の modpack の変更履歴を生成し、バージョンを比較する MCP サーバーです。

ツール

ツール	説明
compare_modpacks	2 つの modpack ディレクトリを比較し、追加・削除・変更された MOD を一覧表示します
generate_changelog	modpack ディレクトリから Markdown 形式の変更履歴を生成します
generate_text_summary	プレーンテキストの概要を生成します（Discord やフォーラムへの投稿に適しています）
get_mod_version_info	Modrinth に問い合わせて MOD のバージョン履歴を取得します（ネットワークが必要です）
save_changelog	生成した変更履歴をファイルに保存します
generate_full_changelog	各 MOD の 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 のベース URL。自前のゲートウェイ／プロキシに対応しています
CHANGELOG_USER_AGENT	mc-changelog-mcp/1.0	リクエストの User-Agent（Modrinth では送信元の明示が必要です）
CHANGELOG_MODS_DIR	mods	modpack 内で MOD が格納されているサブディレクトリ名
CHANGELOG_ENRICH_LIMIT	5	情報を補完（enrich）する際に、各 MOD について返すバージョン数の上限

優先順位：環境変数 > .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

ライセンス

MIT