mc-rp-assistant-mcp

Minecraft 리소스 팩 분석, 검증 및 관리를 위한 MCP 서버입니다. pack.mcmeta를 읽고, 구조를 검증하며, 에셋을 나열하고, 팩을 비교하고, Modrinth를 검색합니다.

도구

Related MCP server: Packwright MCP

내보낸 함수

• readPackMetaExport(packPath) — pack.mcmeta를 읽습니다.

• validateRpStructureExport(packPath, mcVersion?) — 팩 구조를 검증합니다.

• listRpAssetsExport(packPath, limit?) — 에셋 파일을 나열합니다.

• compareRpacksExport(oldPackPath, newPackPath) — 두 팩을 비교합니다.

• searchRpOnModrinthExport(query, limit?) — Modrinth에서 검색합니다.

• getRpInfoExport(slugOrId) — Modrinth에서 팩 정보를 가져옵니다.

• validateTexturesExport(packPath) — 텍스처를 검증합니다.

• analyzeLangFilesExport(packPath) — 언어 파일을 분석합니다.

• compareRpacksDiffExport(oldPackPath, newPackPath) — 상세한 팩 비교.

사용법

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

개발

npm run build   # Compile TypeScript
npm run test:unit  # Run unit tests
npm test        # Run all tests

테스트

npm run build
npm test

모든 단위 테스트는 오프라인으로 실행되며, searchRpOnModrinth와 getRpInfo는 네트워크를 사용할 수 없을 때 정상적으로 빈 결과를 반환합니다.

플랫폼 호환성

모든 도구는 크로스 플랫폼 Node.js fs 및 path API를 사용합니다. .zip 지원에는 adm-zip이 필요합니다. 네트워크에 의존하는 도구(search_rp_on_modrinth, get_rp_info)는 온라인 상태에서 모든 플랫폼에서 작동하며, 오프라인 상태에서는 정상적으로 빈 결과를 반환합니다.

요구 사항

• Node.js 18+

• @modelcontextprotocol/sdk, zod, adm-zip

라이선스

MIT