MCPet

local-only server

The server can only run on the client’s local machine because it depends on local resources.

맥펫

MCPet: AI 시대를 위한 향수 어린 가상 반려동물 경험! 이 모델 컨텍스트 프로토콜(MCP) 서버를 통해 당신의 보살핌에 따라 진화하는 나만의 디지털 반려동물을 입양하고, 키우고, 함께 놀 수 있습니다. 먹이를 주고, 씻기고, 함께 놀고, 아기에서 어른으로 성장하는 모습을 지켜보세요. 반려동물의 능력치는 당신이 없을 때에도 시간이 지남에 따라 변화합니다. 마치 클래식 다마고치 장난감처럼, 모델 컨텍스트 프로토콜을 통해 최신 AI가 구동합니다. 지금 바로 당신의 디지털 친구를 입양하세요!

가상 반려동물 시뮬레이션 시스템을 구현하는 TypeScript 기반 MCP 서버입니다. 반려동물 관리 및 상호작용을 위한 도구를 제공하여 핵심 MCP 개념을 보여줍니다.

특징

가상 반려동물 유형

  • 네 가지 애완동물 유형 중에서 선택하세요:
    • 고양이 - 약간 변덕스럽지만 사랑스럽다
    • 개 - 활기차고 항상 당신을 만나서 기뻐요
    • 드래곤 - 독특하고 열정적인 성격
    • 외계인 - 신비롭고 호기심 많은

반려동물의 수명주기

  • 애완동물이 4단계로 진화하는 모습을 지켜보세요.
    • 아기 - 작고 연약한 아기
    • 아이 - 성장하고 장난기 가득
    • 10대 - 활력이 넘치고 발전적입니다.
    • 성인 - 완전히 성장하고 현명함

통계 관리

  • 5가지 핵심 통계를 관리하여 애완동물을 돌보세요.
    • 배고픔 - 애완동물에게 충분한 배고픔을 유지하세요
    • 행복 - 애완동물과 놀아주어 행복하게 유지하세요
    • 건강 - 다른 통계에 의해 영향을 받는 전반적인 웰빙
    • 에너지 - 활동으로 소모되고 휴식으로 보충됩니다.
    • 청결 - 정기적인 목욕은 애완동물을 상쾌하게 유지합니다.

도구

  • create_pet - 사용자 정의 이름과 유형으로 새로운 애완동물을 입양하세요
  • check_pet - 반려동물의 현재 상태와 통계를 확인하세요
  • feed_pet - 다양한 사료 옵션으로 애완동물에게 먹이를 주세요:
    • 간식 - 약간의 배고픔을 해소
    • 식사 - 균형 잡힌 영양
    • 잔치 - 최대로 먹음 (하지만 건강에 해로울 수 있음)
  • play_with_pet - 다양한 게임을 플레이하세요:
    • 볼 - 가벼운 운동
    • 체이스 - 에너지 넘치는 재미
    • 퍼즐 - 정신 자극
  • clean_pet - 애완동물을 목욕시켜 청결을 되찾으세요
  • put_to_bed - 애완동물이 잠을 자게 하여 에너지를 회복하세요

애니메이션

  • 각 애완동물 유형 및 활동에 대한 동적 ASCII 아트 애니메이션
  • 무작위 프레임은 생동감 있고 매력적인 경험을 만들어냅니다.
  • 다음을 위한 특별 애니메이션:
    • 다양한 음식을 먹다
    • 다양한 게임을 플레이하다
    • 입욕
    • 자고 있는
    • 아프다
    • 그리고 더 많은 것들!

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 MCPet을 자동으로 설치하려면:

npx -y @smithery/cli install @shreyaskarnik/mcpet --client claude

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "mcpet": { "command": "node", "args": ["/path/to/mcpet/build/index.js"], "env": { "PET_DATA_DIR": "/path/to/writable/directory" } } } }

참고: PET_DATA_DIR 환경 변수는 반려동물 데이터가 저장될 위치를 지정합니다. 쓰기 권한이 있는 디렉터리인지 확인하세요.

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector 사용을 권장합니다.

npx @modelcontextprotocol/inspector node /path/to/mcpet/build/index.js

검사관은 애완동물 상호작용을 직접 테스트할 수 있는 인터페이스를 제공합니다.

사용 예

클로드에게 다음과 같은 질문을 해보세요.

  • "위스커스라는 이름의 고양이 애완동물을 만들 수 있나요?"
  • "내 애완동물은 어떻게 지내요?"
  • "반려동물에게 밥을 줄 수 있나요?"
  • "반려동물과 쫓아다니며 놀고 싶어요"
  • "제 애완동물이 더러워 보이는데, 목욕시켜 주실 수 있나요?"
  • "제 애완동물이 피곤해 보이는데, 잠자리에 들게 해 주시겠어요?"
-
security - not tested
A
license - permissive license
-
quality - not tested

AI 시대를 위한 향수어린 가상 반려동물 체험으로, 귀하의 보살핌에 따라 진화하는 디지털 동반자를 입양하고, 키우고, 함께 놀 수 있습니다.

  1. Features
    1. Virtual Pet Types
    2. Pet Lifecycle
    3. Stats Management
    4. Tools
    5. Animations
  2. Development
    1. Installation
      1. Installing via Smithery
      2. Debugging
    2. Usage Examples
      ID: s9n0rbc6rp