Skip to main content
Glama
deenesjakoruzh
dcd887

mc-pack-builder-mcp

by dcd887
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

mc-pack-builder-mcp

Minecraft 모드팩 빌드를 위한 MCP 서버입니다. 팩 구조를 생성하고, Modrinth에서 모드를 검색하며, 의존성을 해결하고, 호환성을 확인합니다.

도구

도구

설명

create_pack

새 모드팩 디렉터리 구조 생성 (pack.mcmeta, version.txt, loader.txt, mods/)

get_pack_info

기존 모드팩 메타데이터 읽기: MC 버전, 로더, 모드 수, 일반적인 문제점

search_mods

키워드로 Modrinth에서 모드 검색, ID, 이름, 설명, 다운로드 수 반환

get_mod_info

Modrinth 모드에 대한 상세 정보: 버전 기록, 의존성, 지원되는 MC 버전

resolve_dependencies

모드의 전체 의존성 체인 재귀적 해결 (직접 + 간접)

check_pack_compatibility

설치된 모드를 대상 MC 버전과 대조하여 알려진 비호환성 확인

generate_dependency_list

기존 팩의 모든 모드에 대한 전체 의존성 목록 생성

Related MCP server: modrinth-mcp

기능

  • 팩 구조 생성 — 모든 필수 파일이 포함된 표준 모드팩 디렉터리 생성

  • Modrinth 통합 — Modrinth API에서 직접 모드 메타데이터 검색 및 조회

  • 의존성 해결 — 전체 의존성 트리를 따라 모든 요구 사항이 충족되는지 확인

  • 호환성 확인 — 알려진 충돌 감지 (예: Fabric과 OptiFine, Sodium 대 Embeddium)

  • 오프라인 작동 — 모든 로컬 팩 도구는 네트워크 없이 작동하며, 검색/정보 도구만 Modrinth가 필요

설치

사전 요구 사항

  • Node.js 18+

  • npm

빌드

cd mc-pack-builder-mcp
npm install
npm run build

독립형 MCP 서버로 실행

node dist/index.js

서버는 stdio(JSON-RPC 2.0)를 통해 통신합니다. MCP 호환 클라이언트에서 사용할 수 있습니다.

MCP 클라이언트 구성

MCP 클라이언트 구성에 추가:

{
  "mcpServers": {
    "mc-pack-builder": {
      "command": "node",
      "args": ["<path/to/mc-pack-builder-mcp>/dist/index.js"]
    }
  }
}

사용 예시

새 모드팩 생성

{
  "name": "create_pack",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "name": "My Modpack",
    "mc_version": "1.20.1",
    "loader": "fabric"
  }
}

Modrinth에서 모드 검색

{
  "name": "search_mods",
  "arguments": {
    "query": "sodium",
    "limit": 5
  }
}

의존성 해결

{
  "name": "resolve_dependencies",
  "arguments": {
    "project_id": "geckolib"
  }
}

팩 호환성 확인

{
  "name": "check_pack_compatibility",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "mc_version": "1.20.1"
  }
}

아키텍처

mc-pack-builder-mcp/
├── src/
│   └── index.ts        # MCP server + all tool implementations
├── dist/               # Compiled JavaScript (output of tsc)
├── __tests__/
│   └── unit.test.ts    # Unit tests (offline)
├── package.json        # Node.js dependencies (@modelcontextprotocol/sdk, zod)
├── tsconfig.json       # TypeScript config (CommonJS output)
├── test.js             # Integration test runner
├── test_logs/          # Test output logs (gitignored)
└── .gitignore

MCP는 공식 @modelcontextprotocol/sdk v1.x와 McpServer 및 StdioServerTransport를 사용합니다.

테스트

npm run build
node test.js

테스트는 os.tmpdir() 아래에 임시 디렉터리를 생성하고 자체적으로 정리합니다. Minecraft 설치가 필요하지 않습니다.

플랫폼 호환성

도구

Windows

macOS

Linux

create_pack

✅

✅

✅

get_pack_info

✅

✅

✅

search_mods

✅

✅

✅

get_mod_info

✅

✅

✅

resolve_dependencies

✅

✅

✅

check_pack_compatibility

✅

✅

✅

generate_dependency_list

✅

✅

✅

모든 도구는 크로스 플랫폼 Node.js fs 및 path API를 사용합니다. 네트워크 의존 도구(search_mods, get_mod_info, resolve_dependencies)는 플랫폼과 관계없이 인터넷 접속이 필요합니다.

라이선스

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • modrinth-mcp

    justinscott12
    A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to search, read, and publish Minecraft mods on Modrinth, including creating projects and uploading jar files as new versions.
    7
    19 npm
    MIT

  • mc-rp-assistant-mcp

    dcd887
    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

  • minecraft-mod-mcp-server

    dcd887
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables Minecraft modpack development by generating FTB Quests chapters and tasks, KubeJS scripts (weapons, armor, recipes), validating SNBT/config files, and providing diagnostic checks.
    MIT