Skip to main content
Glama
deenesjakoruzh
dcd887

minecraft-mod-mcp-server

by dcd887
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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 を使用してプレビューします。

ツール

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

This server cannot be installed

-
license - not tested
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • jsoncanvas

    Create, validate, edit, export (markdown/svg/png/mermaid), and search JSON Canvas files.

  • meok-agents-md-lint-mcp

    MEOK AGENTS.md Linter MCP — validates the cross-vendor coding-agent spec (Cursor / Claude Code /

  • Fresh Jots

    Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dcd887/minecraft-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server