maplestory-mcp-server

[](https://lobehub.com/mcp/ljy9303-maplestory-mcp-server)

NEXON 메이플스토리 오픈 API 데이터에 접근할 수 있는 종합적인 MCP(Model Context Protocol) 서버입니다. Claude Desktop 및 기타 MCP 호환 AI 어시스턴트를 통해 캐릭터 정보, 유니온 세부사항, 길드 데이터, 랭킹, 게임 메커니즘에 구조화된 접근을 제공합니다.

• 캐릭터 정보: 상세한 캐릭터 스탯, 장비, 기본 정보 조회
• 유니온 시스템: 유니온 공격대 구성 및 랭킹 접근
• 길드 관리: 길드 정보 및 멤버 세부사항 조회
• 랭킹: 다양한 리더보드 및 경쟁 데이터 접근
• 게임 메커니즘: 큐브 및 스타포스 강화 확률 정보
• 게임 업데이트: 최신 공지사항 및 발표
• TypeScript 지원: 완전한 타입 안전성 및 IntelliSense 지원
• 종합적인 로깅: 디버깅을 위한 상세한 작업 로깅
• 오류 처리: 상세한 오류 메시지와 함께 강력한 오류 처리

npx maplestory-mcp-server --api-key YOUR_NEXON_API_KEY

npm install -g maplestory-mcp-server

먼저 NEXON 오픈 API 포털에서 API 키를 발급받으세요:

1. NEXON 계정으로 로그인
2. "개발자 센터" → "애플리케이션 관리" 이동
3. "새 애플리케이션 등록" 클릭
4. 애플리케이션 정보 입력 후 등록
5. 생성된 API 키 복사

운영체제별 설정 파일 위치:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

설정 파일에 다음 내용을 추가하거나 수정하세요:

{
  "mcpServers": {
    "maplestory-mcp-server": {
      "command": "npx",
      "args": ["-y", "maplestory-mcp-server"],
      "env": {
        "NEXON_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

> ⚠️ 중요: YOUR_NEXON_API_KEY를 실제 발급받은 API 키로 교체하세요.

설정 파일을 수정한 후 Claude Desktop을 완전히 종료했다가 다시 시작하세요.

Claude Desktop이 재시작되면 새 대화에서 다음과 같이 입력해 연결을 확인하세요:

메이플스토리 API가 정상적으로 작동하는지 확인해줘

성공적으로 연결되면 Claude가 메이플스토리 관련 질문에 답할 수 있습니다!

• get_character_basic_info - 기본 캐릭터 정보 조회 (레벨, 직업, 월드, 길드)
• get_character_stats - 상세한 캐릭터 스탯 및 전투 스탯 조회
• `get_cha