MC-World-MCP

마인크래프트 서버 디렉터리에서 작동하는 오프라인 전용 MCP 도구입니다.

이 MCP는 의도적으로 RCON, 소켓, 온라인 플레이어 쿼리 또는 서버 시작/중지 제어를 사용하지 않습니다. level.dat, 데이터팩, 구조물 템플릿, 로그 및 Anvil 리전 파일과 같은 로컬 파일만 읽고 씁니다.

전체 쓰기 경로는 DataVersion 3465를 사용하는 Java Edition / Arclight 1.20.1 월드를 대상으로 합니다. 다른 Java Anvil 월드는 감지되어 최선의 방법으로 읽기가 가능하지만, 버전 어댑터가 완전히 지원한다고 표시하지 않는 한 월드 쓰기는 거부됩니다. Bedrock LevelDB 월드는 지원되지 않는 것으로 감지됩니다.

실행

이 프로젝트가 E:/VC/mc-world-mcp에 있고 서버 작업 공간이 E:/VC 아래 두 단계에 있는 경우, 작업 공간의 .vscode/mcp.json은 다음을 통해 서버를 시작합니다:

{
  "command": "python",
  "args": ["-m", "mc_world_mcp.server"],
  "env": {
    "PYTHONPATH": "${workspaceFolder}/../../mc-world-mcp/src",
    "MC_SERVER_ROOT": "${workspaceFolder}"
  }
}

MC_SERVER_ROOT는 server.properties와 world/를 포함하는 Arclight 서버 루트를 가리켜야 합니다. 생략할 경우, 서버는 현재 작업 디렉터리를 먼저 시도합니다.

월드 선택은 server.properties의 level-name을 따르므로, level-name=world_regen_source를 사용하는 서버는 하드코딩된 world/ 대신 해당 디렉터리를 통해 작동합니다. 이를 명시적으로 재정의하려면 MC_WORLD_NAME을 설정하십시오.

Related MCP server: ellmos-filecommander-mcp

안전성

모든 쓰기 도구는 다음을 수행합니다:

• MC_SERVER_ROOT 외부의 경로 거부

• java 또는 javaw 프로세스가 실행 중일 때 쓰기 거부

• 선택한 월드가 DataVersion 3465가 아닌 경우 Java 월드 쓰기 거부

• 수정된 모든 파일을 backup/mc_world_mcp/<timestamp>/ 아래에 백업

• 변경된 파일을 설명하는 manifest.json 작성

읽기 도구는 서버가 실행 중일 때도 허용됩니다.

도구 그룹

• 서버/파일: 요약, 안전한 파일 읽기/쓰기, 로그, 버전/플랫폼 감지

• NBT: level.dat, 플레이어 데이터, 월드 데이터, 구조물 NBT

• 데이터팩: 폴더 및 zip 데이터팩 목록, 유효성 검사, 검색, 읽기, 쓰기

• 리전: 스캔, 청크 검사, 블록 가져오기/읽기/설정/채우기/교체, 블록 상태 문자열

• 월드 진단: 차원, 월드 범위, 청크 팔레트, 로그 문제 그룹화

• 월드 데이터: 블록 엔티티, 외부 엔티티 리전, POI 리전, 바이옴 박스, 높이 맵 지우기, 청크 정리

• 템플릿: .nbt 구조물 템플릿 목록/읽기/쓰기, 블록 엔티티 및 최선의 엔티티를 포함한 블록 내보내기/배치

• 안전성: 오프라인 검사, 백업 목록, 백업 복원