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에서 실행됩니다. 배포 후 다음 주소에서 접근할 수 있습니다:

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

로컬 개발에서는 배포 전에 wrangler dev를 사용하여 미리 보기를 할 수 있습니다.

도구

FTB Quests 생성

도구

설명

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 스크립트 생성

도구

설명

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 레시피 제거 코드 생성 (바닐라/모드 레시피 재정의 또는 비활성화)

검증 및 진단

도구

설명

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