lol-client-mcp Public

LoL 클라이언트 MCP

리그 오브 레전드 클라이언트 데이터에 접근하기 위한 MCP(모델-컨트롤러-프로세서) 서버입니다. 이 서버는 리그 오브 레전드 라이브 클라이언트 데이터 API와 통신하여 게임 내 데이터를 가져오는 데 필요한 도구 모음을 제공합니다.

개요

이 프로젝트는 리그 오브 레전드 게임 클라이언트의 라이브 클라이언트 데이터 API를 사용하여 실시간 게임 데이터에 접근합니다. FastMCP 프레임워크를 활용하여 다양한 엔드포인트를 도구로 제공합니다.

API 정보는 https://developer.riotgames.com/docs/lol 에서 확인할 수 있습니다.

설치 및 사용

필수 조건

• Python 3.8 이상
• uv - 빠르고 안정적인 Python 패키지 관리자
  • 설치: pip install uv
• 리그 오브 레전드 클라이언트 설치됨

프로젝트 설정

1. 이 저장소를 복제하세요:

지엑스피1

2. uv를 사용하여 필요한 패키지를 설치하세요:

MCP 서버 실행

직접 실행하려면:

Claude와의 통합

Claude와 함께 이것을 사용하는 방법은 두 가지가 있습니다.

1. Claude 데스크톱 구성

claude_desktop_config.json 파일에 다음을 추가하세요.

중요 : C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp 프로젝트의 실제 경로로 바꾸세요.

2. 웹 애플리케이션과 함께 사용

MCP 서버를 Claude 웹 애플리케이션에 연결하려면:

1. MCP 서버를 실행합니다.
   python main.py
2. Claude 웹 인터페이스에서 서버 연결을 구성합니다.
   • 대화 시작 시 하단의 MCP 설정으로 이동하세요
   • 'lol-client-mcp'를 선택하고 연결하세요

API 도구 목록

게임 데이터

• get_all_game_data() : 라이브 리그 오브 레전드 클라이언트 데이터 API에는 /allgamedata 엔드포인트에서 반환된 데이터의 하위 집합을 반환하는 여러 엔드포인트가 있습니다. 이 엔드포인트는 라이브 클라이언트 데이터 API를 테스트하는 데 유용하지만, 이 엔드포인트의 모든 데이터가 실제로 필요하지 않다면 아래 나열된 엔드포인트 중 응답의 하위 집합을 반환하는 엔드포인트를 사용하세요.
• get_game_stats() : 게임에 대한 기본 데이터.
• get_event_data() : 게임에서 발생한 이벤트 목록을 가져옵니다.

활성 플레이어 데이터

• get_active_player() : 활성 플레이어에 대한 모든 데이터를 가져옵니다.
• get_active_player_name() : 플레이어 이름을 반환합니다.
• get_active_player_abilities() : 활성 플레이어의 능력을 가져옵니다.
• get_active_player_runes() : 활성 플레이어의 룬 전체 목록을 검색합니다.

플레이어 목록 및 개별 플레이어 데이터

• get_player_list() : 게임에 등장하는 영웅 목록과 통계를 검색합니다.
• get_player_scores(riot_id) : 플레이어의 현재 점수 목록을 검색합니다.
• get_player_summoner_spells(riot_id) : 플레이어의 소환사 주문 목록을 검색합니다.
• get_player_main_runes(riot_id) : 모든 플레이어의 기본 룬을 검색합니다.
• get_player_items(riot_id) : 플레이어의 아이템 목록을 검색합니다.

문제 해결

• 연결 오류 : 리그 오브 레전드 클라이언트가 실행 중인지 확인하세요.
• 시간 초과 오류 : 게임이 실제로 시작되었는지 확인하세요. 이 API는 게임 로비에서 작동하지 않습니다.

지침

• 이 API는 League of Legends 클라이언트가 실행 중이고 게임이 진행 중일 때만 작동합니다.
• Riot Games API 정책을 준수하여 사용하세요.

특허

모든 권리는 Riot Games에 있습니다.