PlayFab MCP 서버

이게 뭐예요? 🤔

이 서버는 Claude 및 VS Code와 같은 대규모 언어 모델이 PlayFab 서비스와 직접 상호 작용할 수 있도록 하는 미들웨어입니다. 안전하고 효율적인 번역기 역할을 하는 이 서버는 AI 비서를 아이템 검색, 세그먼트 조회, 플레이어 프로필 조회, 인벤토리 관리, PlayFab ID 변환 등 다양한 PlayFab 기능과 연결합니다.

빠른 예

지엑스피1

어떻게 작동하나요? 🛠️

이 서버는 모델 컨텍스트 프로토콜(MCP)을 활용하여 AI 모델과 PlayFab 서비스 간의 범용 인터페이스를 구축합니다. MCP는 모든 AI 모델을 지원하도록 설계되었지만, 현재 개발자 프리뷰로 제공됩니다.

시작하려면 다음 단계를 따르세요.

1. 프로젝트를 설정합니다.
2. LLM 클라이언트 구성에 프로젝트 세부 정보를 추가합니다.
3. PlayFab 데이터와 자연스럽게 상호작용을 시작하세요!

무엇을 할 수 있나요? 📊

• PlayFab의 search_items API를 사용하여 아이템을 검색하세요.
• 포괄적인 세그먼트 정보를 검색합니다.
• 지정된 세그먼트 내에서 플레이어 프로필을 쿼리합니다.
• get_inventory_items API를 사용하여 현재 재고 항목을 검색합니다.
• get_inventory_collection_ids API를 사용하여 인벤토리 컬렉션 ID를 가져옵니다.
• get_title_player_account_id_from_playfab_id API를 통해 PlayFab ID를 타이틀 플레이어 계정 ID로 변환합니다.

빠른 시작 🚀

필수 조건

• Node.js 14 이상.
• 유효한 PlayFab 계정(PlayFab 게임 관리자를 통해 타이틀 ID와 개발자 비밀 키를 받으세요).
• Claude Desktop과 같은 지원되는 LLM 클라이언트.

프로젝트 설정

PlayFab 게임 관리자에서 PlayFab 타이틀 ID와 개발자 비밀 키를 얻은 다음, 다음 내용이 포함된 .env 파일을 프로젝트 루트에 만듭니다(자리 표시자를 실제 자격 증명으로 바꾸세요).

시작하기

1. 종속성 설치
   프로젝트 루트에서 다음 명령을 실행하여 필요한 모든 종속성을 설치합니다.
   npm install
2. 프로젝트 빌드
   다음을 실행하여 프로젝트를 컴파일합니다.
   npm run build
3. 서버 시작
   dist 폴더로 이동하여 다음을 사용하여 서버를 시작합니다.
   npm start
4. 확인 메시지
   시작하면 다음 메시지가 표시됩니다.
   PlayFab Server running on stdio

VS Code Insiders로 실행하기

VS Code Insiders 및 GitHub Copilot Agent 모드에서 PlayFab MCP 서버를 사용하려면 다음 단계를 따르세요.

1. VS Code Insiders를 설치하세요.
2. VS Code Insiders에서 GitHub Copilot 및 GitHub Copilot Chat 확장 프로그램의 사전 릴리스 버전을 설치합니다.
3. 빈 폴더에서 VS Code Insiders의 새 인스턴스를 엽니다.
4. 이 저장소에서 mcp.json 파일을 귀하의 폴더로 복사하고 귀하의 환경에 맞게 값을 업데이트합니다.
5. GitHub Copilot을 실행하고 에이전트 모드로 전환하면 도구 목록에 PlayFab MCP 서버가 나타납니다.
6. 예를 들어, "최근 10개 항목 표시"와 같은 프롬프트를 사용해 서버가 쿼리를 올바르게 처리하는지 확인하세요.

Claude Desktop의 구성 파일에 프로젝트 세부 정보 추가

Claude Desktop을 열고 파일 → 설정 → 개발자 → 구성 편집으로 이동합니다. 그런 다음 claude_desktop_config 파일 내용을 다음 코드로 변경합니다.

이러한 단계를 거치면 LLM 클라이언트와 함께 사용할 PlayFab MCP 서버를 성공적으로 구성하여 PlayFab 서비스와 원활하게 상호 작용할 수 있습니다.