안녕하세요. 메이플 정보를 AI에 연결해주는 MapleMate라는 mcp 서버를 만들어봤습니다.

공식 넥슨 API로 캐릭터 정보를 가져오고, 필요한 화면과 계산 도구를 AI에 연결해서 질문할 수 있게 만들었습니다. 현재 Claude Desktop과 Codex에서 사용할 수 있습니다.

이런 식으로 질문할 수 있습니다.

  • “지금 접속 중인 캐릭터 정보 정리해줘.”
  • “이 반지 500억인데, 지금 장비에서 바꾸면 최종뎀 얼마나 올라?”
  • “하드 림보 솔플이 목표인데, 내 예산에서 뭘 먼저 바꾸는 게 좋을까?”
  • “이번 이벤트에서 내 캐릭터가 챙길 만한 보상 알려줘.”

그러면 AI는 답변에 필요한 정보들을 얻기 위해 MapleMate를 통해서 넥슨 api 조회를 하거나 api로는 확인할 수 없는 인게임 정보들(경매장 매물이라던가, 보유중인 메소 등등)을 화면 캡쳐로 제공받습니다. 또한 유저가 AI와 대화하면서 캐릭터별 목표나 예산, 성장 수준 등을 저장해두고 사용하기도 합니다.

사용예시로는

이렇게 써볼수도 있고..


이렇게 써볼수도 있습니다.

활용은 매우 다양할 것 같습니다. 가장 기대하는 것은 메이플이 아직 익숙치 않으신 분들의 사용감입니다. 여러 방면으로 써보고 경험을 남겨주시면 큰 도움이 됩니다.

사용 방법

  1. 아래 GitHub Releases에서 ZIP을 받고 폴더 전체를 압축 해제합니다.
  2. MapleMate.exe를 실행하고(이때 윈도우의 PC 보호 창이 뜰 수 있는데 그냥 실행하시면 됩니다) 본인의 Nexon Open API 키를 등록합니다.
  3. 설정에서 Claude Desktop 또는 Codex를 연결하고, 해당 AI 앱을 재시작합니다.
  4. AI에게 MapleMate로 질문합니다.

Claude Desktop/code나 Codex 앱과 Nexon API 키(서비스 단계 키 권장)는 별도로 준비해야 합니다. AI 서비스 이용 비용과 제한은 사용하는 서비스·플랜을 따릅니다.

AI의 설명이나 화면 판독에는 오류가 있을 수 있고, API에서 얻을 수 없는 세부 수치는 추가 입력이 필요할 수 있습니다. 최종뎀 계산도 입력값과 적용 조건에 따라 달라집니다.

MapleMate는 연결한 AI 서비스 외에 어디에도 연결되지 않습니다. 모든 정보는 로컬에 저장됩니다. 다만 AI에게 질문을 할 땐 민감한 개인정보는 지양하시길 바랍니다. 

소스코드는 GitHub에서 확인할 수 있습니다.


다운로드: https://github.com/nullpo0/MapleMate/releases/tag/v1.0.1