songconmaisaix31-design/mcpet

MCP desktop companion for AI agent status, usage tracking, and everyday tools. Anything Universe · 桌面伙伴与日常工具入口。

McPet – AI 기반 데스크톱 컴패니언

소개

화면에 상주하며 LLM(DeepSeek 또는 ChatGPT)을 통해 대화하는 작은 데스크톱 "펫"입니다. AI 에이전트 세션 상태와 로컬 토큰 사용량을 표시하며, 식사나 커피 시간을 알려줍니다.
또한 저렴한 음식 서비스와 통합되어 있어 맥도날드 쿠폰 및 루이싱 커피 메뉴 조회, (데모) 주문 생성, 영양 기록이 가능합니다.

주요 기능

기능	액세스 방법
데스크톱 컴패니언	펫 드래그, 클릭, 우클릭; 트레이에서 숨기기/표시.
캐릭터 및 의상	DeepSeek‑娘 와 ChatGPT‑娘 간 전환; "麦麦套装" 또는 "炸薯条" 스킨 적용.
작업 세션 모니터링	펫이 읽을 수 있는 로그를 출력하는 모든 LLM 세션의 진행 상황, 입력 대기, 오류 표시.
토큰 및 잔액 보기	로컬 토큰 계산, Orca 캐시, 타임스탬프가 포함된 DeepSeek 잔액 표시.
맥도날드 및 루이싱 커피	쿠폰, 매장 정보, 실시간 가격 검색; 확인을 통해 데모 주문 생성 또는 취소.
영양 기록	메뉴 항목의 영양 성분 조회, 섭취량 기록, 일일 총합 확인.
시간 알림	기본 11:30 am(식사) 및 15:00 pm(커피) 알림; 설정 메뉴에서 구성 가능.

설치 경로

Windows 포터블 버전 – 릴리스 페이지에서 zip을 다운로드하고 압축을 푼 뒤 Start-Pet.vbs를 더블 클릭합니다. 번들에는 빌드된 McPet.exe와 런타임이 포함되어 있어 별도의 설치가 필요 없습니다.
에이전트 모드 – 이미 LLM 세션을 호스팅하는 도구의 경우, Agent zip을 다운로드하고 Python 3.10+ 의존성(pip install -r requirements‑agent.txt)을 설치한 후, src.agent_install을 실행하여 server.command/server.args 쌍을 얻고 호스트의 MCP 설정을 mcpet 서비스(STDIO 전송)로 지정합니다.
소스에서 빌드 – 리포지토리를 클론하고 가상 환경을 생성한 뒤 requirements.txt를 설치하고 python -m src.main --desktop을 실행합니다. UI는 PySide6(Qt)로 구축되었습니다.

일반적인 워크플로우

구성

맥도날드 및 루이싱 커피 토큰은 로컬 .env 파일에 저장됩니다. 리포지토리에는 공유 데모 자격 증명이 포함된 .env.trial이 제공되므로 자신의 키를 제공하지 않고도 쿼리 기능을 테스트할 수 있습니다.
기타 모든 설정(알림 시간, 선택한 스킨, UI 기본 설정)은 펫의 데이터 디렉토리에 저장되며 실행 간에 유지됩니다.

현재 상태

릴리스 버전은 v0.1.0(Python/Qt)입니다. Tauri 기반 네이티브 빌드와 커스텀 "오리지널" 캐릭터는 초기 M0 개발 단계에 있습니다.
일부 고급 GIF 기반 애니메이션은 추가 에셋을 로컬로 가져와야 합니다. 기본 zip에는 핵심적인 15개의 애니메이션 동작이 포함되어 있습니다.
주문 기능은 데모입니다. 펫이 요약 정보를 보여주고 확인을 요청하지만, 실제 결제는 공식 브랜드 앱에서 완료해야 합니다.

더 알아보기

McPet은 장난기 넘치는 데스크톱 마스코트와 실용적인 AI 에이전트 모니터링 및 일상 편의 서비스를 결합하여, 머신에서 LLM을 실행하는 개발자를 대상으로 합니다.