🤖AI 에이전트와 MCP

• 무엇: AI가 말만 하는 데서 그치지 않고 게임·프로그램을 직접 조작하는 ‘AI 에이전트’ 사례 네 가지
• 누구: 교사 연수, 중·고등학생 코딩·AI 동아리 (설치가 복잡해 교사 시연을 권함)
• 시간: 사례 소개 2030분, 바이브코딩·Blockbench 실습은 12차시
• 결과물: AI가 만든 커스텀 아이템·블록, 테마에 맞게 바뀐 NPC 스킨·소품 모델
• 핵심 메시지: AI가 대신해 주는 일은 많지만, 무엇을 만들지 정하고 결과를 확인하는 일은 사람이 한다

• MCP: Model Context Protocol — AI가 외부 프로그램을 도구처럼 쓰게 하는 연결 방식
• “나무를 모아 집을 지어 줘” → 이동·블록 놓기·아이템 관리 명령으로 바꿔 실행
• 흐름: 2023 ChatGPT NPC(대화만) → 2025 MCP 봇(게임 속 행동) → 2026 AI 코딩 도구가 애드온·3D 모델 파일을 직접 만듦
• 한계: MCP 봇은 자바 에디션 서버에서만 가능, 결과가 아직 정확하지 않음
• 참고: 교실 수업용이라기보다 ‘AI가 도구를 쓰는 시대’를 보여 주는 사례로 소개

• 자바 에디션 서버 ‘인천크래프트’(서버 주소 incheoncraft.co.kr)의 스티브 잡스 NPC
• NPC에게 말을 걸면 “채팅으로 대화하실 수 있습니다. 대화를 취소하시려면 ‘취소’라고 말해주세요.”
• “인천에 대해서 소개해주세요!” → 답은 하지만 길게 말하지 못해 “계속 말해요.”를 입력해야 이어짐
• “ChatGPT인가요?”라고 물으면 아니라고 했다가 다시 그렇다고 답함 → AI 답을 그대로 믿지 않기 토론 소재

1. 준비: Node.js, Claude Desktop 앱(웹 버전 안 됨), 마인크래프트 자바 에디션 1.21.4(1.21.5 미지원)
2. Claude Desktop 설정 → 개발자 → 설정 편집 → claude_desktop_config.json에 GitHub 페이지의 설정 붙여 넣기
3. 작업 표시줄 트레이에서 Claude를 완전히 종료(창 닫기 아님)
4. 싱글플레이 월드에서 Game Menu → Open to LAN(포트 25565)
5. Claude 다시 실행 → 게임에 “ClaudeBot joined the game” 메시지
6. Claude에 자연어로 요청 → 도구 사용 허용 창에서 ‘이 대화에 허용’

• claude_desktop_config.json에 넣는 설정(영상 화면·설명란 원문). --username 값이 게임 속 봇 이름이 됩니다.

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

• 설명란: 채팅창 옆에 망치 아이콘이 나타나면 MCP 서버가 실행된 것

• 영상에서 넣은 요청: “곡괭이를 명령어로 얻은 뒤 땅을 파서 석탄을 캐서 stevecoding에게 가져와서 던져줘.” / “바닥 아래 계단식으로 채굴을 하면서 돌 블록 50개를 모아.” / “현재 위치에서 작은 집을 만들어 봐” / “다이아몬드 칼을 명령어로 가져온 뒤, 주변에 있는 몹을 잡아서 식량을 얻어.” / “위로 올라가는 물 엘리베이터 만들어줘.”
• AI가 고른 도구: list-inventory, find-item, find-block, find-entity, get-position, move-to-position, equip-item, place-block, look-at, send-chat
• 걸어 다니며 블록 놓기는 서툴러서 “명령어를 사용해서 집을 빠르게 생성해 보겠습니다”로 바꿈 → send-chat으로 /give @s bone_meal 25 같은 명령어 실행

1. 월드 폴더 열기: AI 편집기(안티그래비티)에서 월드 폴더를 열고 시작
2. 말로 요청: “마법 아이템 만들어 줘” → 행동 팩·리소스 팩을 AI가 생성
3. 오류는 붙여 넣기: 콘텐츠 로그를 그대로 주면 원인(조합법 충돌)을 찾아 고침
4. 다시 불러오기: 월드 안 팩은 /reload all, 리소스 팩은 재시작해야 보임

• 잘 된 것: 마법 지팡이·블록, 조합법, 텍스처를 한 번에 / 막힌 것: NPC 요청 → 새 엔티티·베타 API로 꼬임
• 결론: 먼저 정해 줄 것 — 바닐라 NPC냐 새 엔티티냐, 스크립트냐 mcfunction이냐 → 기본 지식은 여전히 필요

• 크리에이티브 월드를 하나 만들어 저장하고 나온 뒤, Antigravity IDE의 Open Folder로 그 월드 폴더를 엶
• 첫 요청: “현재 프로젝트는 마인크래프트 월드야. 새로운 애드온을 생성해줘.” (모델 Gemini 3.1 Pro (High))
• AI가 되물은 선택지: 커스텀 아이템 및 블록 애드온(추천) / 스크립트 API 스타터 애드온 / 커스텀 엔티티(NPC/몹) 애드온 / 기본 애드온 템플릿 → 실험 기능 월드가 아니라 아이템을 고름
• AI가 만든 것: 행동 팩(blocks, items, recipes, manifest.json), 리소스 팩(텍스처 PNG, en_US.lang·ko_KR.lang), README.md 사용 안내 → Accept All로 반영
• 이름을 정해 주지 않으면 AI가 알아서 붙임(영상에서는 ‘고우에듀 커스텀 애드온’)

• 마법 블록 조합법(magic_block_recipe.json): 다이아몬드 8개로 발광석 1개를 둘러쌈

{
  "format_version": "1.20.0",
  "minecraft:recipe_shaped": {
    "description": { "identifier": "custom:magic_block_recipe" },
    "tags": ["crafting_table"],
    "pattern": ["DDD", "DGD", "DDD"],
    "key": {
      "D": { "item": "minecraft:diamond" },
      "G": { "item": "minecraft:glowstone" }
    },
    "result": { "item": "custom:magic_block", "count": 1 }
  }
}

• README의 바로 받기 명령어: /give @s custom:magic_wand, /give @s custom:magic_block
• 텍스처는 16×16 또는 32×32 PNG로 바꿔 넣을 수 있음(README 안내)

• 월드에 들어가자 경고: 콘텐츠 로그 기록 → 클립보드로 복사

[Recipes][warning]-Recipe "minecraft:diamond_spear" has the same ingredients as custom:magic_wand's recipe but outputs minecraft:diamond_spear instead. Adding duplicate crafting_table recipe.

• 설명 없이 붙여 넣기만 함 → AI: 새로 추가된 다이아몬드 창 조합법과 마법 지팡이 조합법이 같다고 진단
• 고친 마법 지팡이 조합법: 가운데 막대기를 금괴(minecraft:gold_ingot)로 → 위에서부터 다이아몬드 / 금괴 / 막대기
• 월드 안에서 만든 팩이라 /reload all로 다시 시작해야 반영됨

• 요청: “사칙연산 문제를 내는 NPC를 만들어줘” (보통은 기존 NPC에 대화 JSON을 넣어 만듦)
• AI는 스크립트 API(@minecraft/server, @minecraft/server-ui)로 새 엔티티 custom:math_npc와 main.js를 만듦
• 안내된 사용법: /summon custom:math_npc, 채팅에 !수학·!math·!퀴즈, 월드 설정에서 베타 API(Beta APIs) 실험 기능 켜기
• 결과: 불러오기 중 [Actor][error]-error parsing entity/math_npc.json 오류, 스폰 알도 보이지 않음
• 교훈: 바닐라 NPC냐 새 엔티티냐, 스크립트냐 mcfunction이냐를 먼저 정해서 요청하기

• 바꾼 예: 스티브 ▼ 영의정 황희 / 개럿 ▼ 장영실 / 회전 바퀴 ▼ 혼천의
• Blockbench: 스킨·아이템·엔티티 3D 모델링 도구
• MCP 플러그인: AI 코딩 도구(Claude Code 등)가 블록벤치를 직접 조작 / 연결 방법도 AI에게 물어서 따라 하기 / 블록벤치를 열어 두고 프롬프트만 입력 → 모델·스킨 생성
• 요청 요령: 첫 결과가 기존 틀을 못 벗어나면 → 바꿀 점을 구체적으로 다시 요청 / 모델만 바꾸지 말고 대사·게임 이름까지 테마에 맞추기

• Claude Code에 “블록벤치 어떻게 연결하냐”고 묻고 안내대로 연결

1. Blockbench 데스크톱 앱에서 File → Plugins → Load Plugin from URL → 플러그인 주소 붙여 넣기
2. 터미널에서 claude mcp add blockbench --transport http http://localhost:3000/bb-mcp
3. Claude Code 다시 시작(MCP 도구는 새 세션에서만 불러옴)

• 작업하는 동안 Blockbench를 켜 두기. 연결되면 Blockbench 오른쪽 MCP 패널에 claude-code 세션, 아래에 ‘MCP Server (1 client)’가 보임

• 첫 요청: “블록 벤치 MCP를 활용해서 우리 컨셉에 맞는 스킨으로 재생성 하려고 해. 개발자 페이지를 참고해서 잘작동하는 지 확인하기 위해 예시로 하나를 생성해보자.” → 주인공(스티브)이 영의정 황희로
• “이번에는 스티브의 바퀴를 혼천의로 바꿔줘.” → AI가 모델은 그대로 두고 텍스처만 다시 그려 기존 틀에 갇힘
• 다시 요청: 기존 스티브 바퀴의 형태를 무시하고 새로 만들라고 함(화면에서 일부만 보임) → honcheonui.geo.json·honcheonui.png로 새 모델
• 혼천의는 AI가 잘 아는 유물이라 이미지를 따로 붙이지 않음

• 에듀케이션 에디션 월드 ‘스티브의 바퀴’ → 경복궁 테마로 바뀐 모습
• 바퀴 돌리기 → ‘혼천의 돌리기’: “호스트는 혼천의를 돌릴 수 있습니다.”
• 대사도 테마에 맞게: “나는 영의정 황희라네. 옥새 쟁탈전을 해 보세! 이 대결에서 이기려면 소통이 무엇보다 중요하다네.”
• 아직 스킨을 바꾸지 않은 캐릭터는 예전 얼굴 그대로 → 바꿀 범위를 정해서 요청하기

• MCP 봇·Blockbench MCP는 설치가 복잡하므로 교사가 미리 연결해 두고 시연하기
• 요청은 구체적으로: 무엇을(바닐라 NPC/새 엔티티), 어떻게(스크립트/mcfunction), 어디까지(바꿀 캐릭터) 정해 주기
• 오류가 나면 콘텐츠 로그를 복사해 그대로 붙여 넣기
• 첫 결과가 마음에 안 들면 무엇이 다른지 말로 짚어 다시 요청하기(혼천의 사례)
• AI가 고른 방법(명령어로 해결, 텍스처만 바꿈)을 함께 살펴보며 ‘AI가 문제를 어떻게 푸는가’ 토론하기