Skip to main content
Glama
dcd887

minecraft-mod-mcp-server

by dcd887

minecraft-mod-mcp-server

Minecraft モッドパック開発のための Cloudflare Workers MCP サーバー。FTB Quests のチャプターとタスク、KubeJS スクリプト(武器、防具、レシピ)を生成し、SNBT/設定ファイルを検証し、診断チェックを提供します。

デプロイ

この MCP は Cloudflare Workers 上で動作します。デプロイ後、以下の URL でアクセスできます:

https://<your-worker>.<your-subdomain>.workers.dev/mcp

ローカル開発では、デプロイ前に wrangler dev を使用してプレビューします。

Related MCP server: Datapack MCP Server

ツール

FTB Quests 生成

Tool

Description

generate_quest_chapter

複数のタスク、依存関係、報酬を含む完全な FTB Quests チャプターファイル(SNBT 形式)を生成します

generate_quest_task

単一の FTB Quests タスク定義(アイテム/キル/進捗/チェックリストタイプ)を生成します

generate_hex_id

FTB Quests のチャプター/タスク ID 用に 16 ビットのランダムな 16 進数 ID を生成します

generate_chapter_group_snbt

クエストブックのグループ化(メイン/ブランチクエスト)を定義する chapter_groups.snbt を生成します

generate_quest_data_snbt

クエストブックのメイン設定(タイトル、アイコン、進行モード)を生成する data.snbt を生成します

KubeJS スクリプト生成

Tool

Description

generate_kubejs_weapon

KubeJS 武器登録コード(攻撃力、速度、耐久値、スキル)を生成します

generate_kubejs_armor_set

KubeJS 防具セット登録コード(ヘルム/チェスト/レギンス/ブーツ、ティア定義付き)を生成します

generate_kubejs_shaped_recipe

KubeJS 整形レシピコード(材料マッピング付き 3x3 クラフトパターン)を生成します

generate_kubejs_shapeless_recipe

KubeJS 無整形レシピコード(材料と出力のみ)を生成します

generate_kubejs_smelting

KubeJS 精錬/かまど/スモーカーのレシピコードを生成します

generate_kubejs_remove_recipe

KubeJS レシピ削除コード(バニラ/Mod レシピの上書きまたは無効化)を生成します

検証と診断

Tool

Description

validate_snbt

SNBT ファイルの構文を検証します(対応していない中括弧、Count 形式の問題などをチェック)

check_kubejs_errors

KubeJS スクリプトの一般的なエラー(非推奨 API、Rhino エンジンの互換性問題)をチェックします

generate_item_texture_path

正しいファイル配置のための KubeJS アイテム/防具テクスチャパスガイドを生成します

機能

  • FTB Quests 生成 — 依存関係、報酬、グループ化を含むクエストブック用の完全な SNBT 出力

  • KubeJS スクリプト生成 — 武器、防具、整形/無整形/精錬レシピ、レシピ削除

  • SNBT 検証 — ゲーム内でランタイム問題を引き起こす前に構文エラーを検出

  • KubeJS 診断 — 非推奨 API と Rhino エンジンの互換性問題を検出

  • ネットワーク依存ゼロ — すべての生成は純粋にアルゴリズムベースで、外部 API は呼び出しません

  • Cloudflare Workers デプロイ — Workers エッジネットワークを介して低遅延でグローバルに実行

インストール(ローカル開発)

前提条件

セットアップ

cd minecraft-mcp-server
npm install

ローカルで実行

npm start
# or
npx wrangler dev

その後、MCP クライアントから http://localhost:8788/mcp に接続します。

Cloudflare へのデプロイ

npm run deploy

MCP クライアントの設定

デプロイ後、MCP クライアントの設定に以下を追加します:

{
  "mcpServers": {
    "minecraft-mod": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-stdio"],
      "env": {
        "MCP_SERVER_URL": "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
      }
    }
  }
}

または、HTTP ベースの MCP クライアントを使用する場合:

{
  "mcpServers": {
    "minecraft-mod": {
      "url": "https://<your-worker>.<your-subdomain>.workers.dev/mcp"
    }
  }
}

<your-worker> と <your-subdomain> を実際の Cloudflare Workers デプロイ URL に置き換えてください。

アーキテクチャ

minecraft-mcp-server/
├── src/
│   ├── index.ts           # Cloudflare Worker entry point + MCP server setup
│   ├── types.ts           # Cloudflare Workers environment types
│   ├── tools/
│   │   ├── quest.ts       # FTB Quests generation logic
│   │   ├── kubejs.ts      # KubeJS script generation logic
│   │   └── validate.ts    # SNBT validation + KubeJS diagnostics
│   └── templates/
│       ├── quest_chapter.ts
│       ├── kubejs_item.ts
│       └── kubejs_recipe.ts
├── __tests__/
│   └── unit.test.ts       # Unit tests (fully offline, 49 tests)
├── vitest.config.ts       # Vitest config (ESM, globals: false)
├── package.json           # Dependencies (@modelcontextprotocol/sdk, agents, zod, wrangler)
└── wrangler.jsonc         # Cloudflare Workers deployment config

MCP サーバーは @modelcontextprotocol/sdk v1.x 上に構築され、agents ライブラリの createLegacyMcpHandler を使用して Cloudflare Worker としてデプロイされます。

テスト

npm test
# or
npx vitest run

49 件のユニットテストはすべて完全にオフラインで実行されます。テストにネットワークや Cloudflare アカウントは必要ありません。

プラットフォーム互換性

アスペクト

Windows

macOS

Linux

ローカル開発(wrangler dev)

✅

✅

✅

ユニットテスト(vitest)

✅

✅

✅

本番デプロイ

✅ (Cloudflare)

✅ (Cloudflare)

✅ (Cloudflare)

MCP クライアント接続

✅

✅

✅

この MCP は完全に Cloudflare Workers インフラストラクチャ上で動作します。唯一のプラットフォーム依存は、Workers が有効な Cloudflare アカウントを持っていることです。すべての生成ロジックは純粋な JavaScript/TypeScript であり、完全にクロスプラットフォームです。

ライセンス

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables document retrieval, code generation, and code review for Minecraft China (NetEase) ModSDK development. It automates the creation of Mod projects, JSON configurations, and Python scripts while ensuring compliance with official development standards.
    93
    GPL 3.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables creating Minecraft modpack structures, searching Modrinth mods, resolving dependencies, and checking compatibility.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables reading, validating, and managing Minecraft resource packs, including structure checks, asset listing, pack comparison, and Modrinth queries.
    MIT