LOA_MCP_Server

earlgrey940208/LOA_MCP_Server

3.2

If you are the rightful owner of LOA_MCP_Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This project provides the official Lost Ark API as a Model Context Protocol (MCP) server.

Tools
2
Resources
0
Prompts
0

로스트아크 헬퍼 MCP 서버

로스트아크 공식 API를 MCP(Model Context Protocol) 서버로 제공하는 프로젝트입니다.

구현 Rule

  • 최우선 원칙 : 간단하게, 최소한의 수정으로 개발 할 것
  • 요청하지 않은 것은 개발하지 않을 것
  • 먼저 개발하기 전에 어떤 파일을 어떻게 수정할지 개발자에게 확인받을것

주요 기능

개발 예정 기능

  • 캐릭터 정보 조회: 캐릭터 기본 정보, 아이템 레벨 등
  • 원정대 정보 조회: 원정대 캐릭터 목록
  • 장비 정보 조회: 캐릭터 장비, 각인 정보
  • 길드 정보 조회: 길드 기본 정보

기술 스택

  • Runtime: Node.js
  • Language: TypeScript
  • Protocol: MCP (Model Context Protocol)
  • API: 로스트아크 공식 API

프로젝트 구조

src/
├── server.ts          # MCP 서버 메인
├── tools/             # API 도구들
│   ├── character.ts   # 캐릭터 관련 도구
│   ├── guild.ts       # 길드 관련 도구
│   └── index.ts       # 도구 내보내기
├── types/             # 타입 정의
│   └── lostark.ts     # 로스트아크 API 타입
└── utils/             # 유틸리티
    └── api.ts         # API 클라이언트

개발 순서

1단계: 기본 프로젝트 설정

  • package.json - 의존성 및 스크립트 설정
  • tsconfig.json - TypeScript 설정
  • .gitignore - Git 무시 파일
  • 기본 폴더 구조 생성 2단계: MCP 서버 기본 틀
  • src/server.ts - 기본 MCP 서버 설정 (빈 도구 배열로 시작)
  • 서버가 정상 실행되는지 확인 3단계: API 클라이언트 기초
  • src/utils/api.ts - 로스트아크 API 기본 클라이언트
  • src/types/lostark.ts - 기본 타입 정의 4단계: 첫 번째 기능 (캐릭터 조회)
  • src/tools/character.ts - 캐릭터 정보 조회 도구
  • 테스트 및 검증 5단계: 추가 기능들
  • 원정대, 장비, 길드 기능 순차 추가

설치 및 실행

npm install
npm run dev

테스트

npm test