카테고리 없음

마비노기 모바일 MCP

만군마 2026. 9. 21. 00:54

이 글은 2026년 9월 21일 기준으로 로컬 실행 파일과 MCP 중계 프로그램을 직접 점검한 결과입니다.

마비노기 모바일용 MCP를 Codex에 연결해 실제 기능과 동작 구조를 확인해 봤습니다.

 

1. 전체 동작 구조

사용자가 자연어로 요청하면 Codex가 적절한 도구를 선택하고, 로컬 MCP 중계 프로그램이 그 요청을 마비노기 모바일 CLI 명령으로 전달합니다.

실제 이동·채집·제작 같은 게임 동작은 AI가 직접 화면을 조작하는 방식이 아니라 게임 CLI가 수행합니다.

사용자 요청→ Codex → MCP 중계 프로그램 → MabinogiMobile_CLI.exe → 게임
게임 결과 → CLI → MCP 중계 프로그램 → Codex → 사용자
  • Codex: 자연어 해석, 명령 선택, 결과 설명
  • MCP 중계 프로그램: JSON-RPC 요청을 CLI 명령으로 변환
  • 게임 CLI: 게임과 통신해 상태를 조회하거나 실제 행동을 실행
  • 게임: 이동, 채집, 제작, 연주 등 실제 동작 수행

2. 확인된 기능

현재 공개된 게임 명령은 28개이며, 중계 프로그램의 연결 확인 명령을 포함하면 총 29개입니다.

조회 기능은 20개, 실행 기능은 9개입니다.

  • 캐릭터·환경: 위치, 날씨, 게임 시간, 능력치, HP, 포만감, 가방 무게, 현재 행동
  • 퀘스트·임무: 퀘스트 추적 목록, 일일·주간 임무, 재화 확인
  • 주변 정보: 대화 가능한 NPC와 주변 플레이어 조회
  • 아이템: 재료·음식 수량, 보관 위치, 인벤토리 무게 확인
  • 음악: 악기와 악보 조회, 악기 장착, 보유 악보 연주
  • 소셜: 행동·표정 조회, 채팅과 행동 명령 전송
  • 행동 제어: 자동 플레이·채집·연주 중지, 일어서기
  • 채집·낚시: 채집 가능 대상과 도구 상태 조회, 자동 이동 후 채집 또는 낚시 시작
  • 가공: 레시피·재료 조회, 가공 시작, 진행 확인, 완료품 수령
  • 제작: 제작 가능 항목과 부족 재료 조회, 제작 실행

※ 현재 제공되지 않는 기능 : 던전 입장, 공격·스킬 조작, 장비 수리, 상점 구매가 없습니다.

MCP를 연결하는 것만으로 이런 기능이 새로 생기지는 않습니다.

 

3. 게임 안에서 드는 비용

기능 설명상 채집, 가공 시작, 제작 실행은 각각 호출할 때마다 정령의 날개 5개를 사용합니다.

채집은 한 번에 지정 아이템을 최대 100개까지 모으지만, 도구 내구도·가방 무게·필요 소비품·사용자 입력이 필요한 화면 등의 조건에 따라 일찍 종료될 수 있습니다.

 

4. AI 토큰은 어디서 사용되나

MCP 중계 프로그램과 게임 CLI 자체는 OpenAI API를 호출하지 않습니다.

토큰은 Codex가 사용자의 말을 해석하고, 도구 설명과 게임 결과를 읽고, 다음 행동을 판단하고, 답변을 작성할 때 사용됩니다.

  • 게임이 혼자 이동하거나 채집하는 시간 자체는 모델 토큰을 계속 소비하지 않음
  • 상태를 확인하기 위해 Codex를 반복 호출하면 매번 사용량이 추가됨
  • 긴 아이템 목록이나 전체 기능 설명을 모델에 전달하면 입력 사용량이 증가함
  • 완료·오류가 생길 때만 AI를 호출하도록 만들면 사용량을 크게 줄일 수 있음

 

5. 현재 구현에서 개선할 점

  1. 장시간 작업 추적: 실행 식별자와 최종 결과를 보존해야 합니다.
  2. 로컬 상태 감시: AI가 반복 조회하지 않고 로컬 프로그램이 완료·오류 때만 알려야 합니다.
  3. 비동기 처리: 긴 채집 작업 중에도 상태 조회와 중지 명령을 받을 수 있어야 합니다.
  4. 목표·비용 상한: 시작 수량, 추가 목표, 최대 실행 횟수와 게임 재화 소모량을 기록해야 합니다.
  5. 명령별 입력 검증: 범용 문자열 대신 아이템명, 제작 횟수 같은 필드를 명확한 스키마로 제공해야 합니다.
  6. 도구 설명 축소: 필요한 명령만 모델에 노출해 토큰 사용량을 줄일 수 있습니다.

 

6. 다른 게임에도 적용할 수 있을까?

가능합니다. 다만 해당 게임을 제어할 공식 API, CLI, 모드 또는 플러그인 SDK가 필요합니다. 자연어 해석과 MCP 연결, 작업 상태 관리 구조는 재사용할 수 있지만 실제 게임 조작부는 게임마다 새로 만들어야 합니다.

  • 공식 CLI·행동 API가 있는 게임: 현재 구조처럼 직접 MCP 도구로 연결
  • 모드·플러그인 SDK가 있는 게임: 게임 내부 플러그인이 상태와 행동 함수를 제공
  • 개인 서버 명령이 있는 게임: 서버 관리 명령과 허용된 게임 명령을 MCP로 노출
  • 로그·저장 파일만 제공하는 게임: 상태 분석과 추천 기능 위주로 구성
  • 화면·키보드·마우스만 가능한 게임: 별도의 화면 인식과 입력 자동화가 필요하며 UI 변경과 지연에 취약

던전 자동화를 예로 들면 입장, 이동·전투, 사망·보스 상태, 완료·보상, 중지 기능이 모두 필요합니다. 현재 마비노기 모바일 CLI에는 이 행동 명령들이 공개되어 있지 않아 MCP만으로 던전을 자동 완주할 수는 없습니다.

 

7. 권장 설계

비용과 안정성을 함께 잡기 위해서는 AI가 목표를 정하고, 게임별 실행 프로그램이 반복 행동을 처리하며, 완료나 예외만 AI에게 보고하는 구조가 적합합니다.

이렇게 하면 오래 걸리는 채집이나 제작 작업도 모델 호출 횟수를 최소화하면서 안정적으로 관리할 수 있습니다.

이 분석은 현재 설치된 마비노기 모바일 CLI가 공개한 기능을 기준으로 합니다.

게임과 CLI가 업데이트되면 사용 가능한 명령과 비용 조건도 달라질 수 있습니다.