songconmaisaix31-design/mcpet

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

McPet – AI搭載デスクトップコンパニオン

概要

画面上に常駐し、LLM（DeepSeekまたはChatGPT）を通じてあなたと対話する小さなデスクトップ「ペット」です。AIエージェントのセッション状態やローカルのトークン使用量を表示し、食事やコーヒーの時間をリマインドします。
また、お得なフードサービスと統合されており、マクドナルドのクーポンやLuckin Coffeeのメニュー検索、(デモ)注文の作成、栄養記録が可能です。

主な機能

機能	アクセス方法
デスクトップコンパニオン	ペットのドラッグ、クリック、右クリック；トレイから表示/非表示。
キャラクターと衣装	DeepSeek‑娘と ChatGPT‑娘の切り替え；「麦麦套装」や「炸薯条」スキンの適用。
ワークセッション監視	ペットが読み取れるログを出力するあらゆるLLMセッションの進捗、入力待ち、エラーを表示。
トークンと残高表示	ローカルのトークン計算、Orcaキャッシュ、タイムスタンプ付きのDeepSeek残高を表示。
マクドナルドとLuckin Coffee	クーポン、店舗情報、リアルタイム価格の検索；確認してデモ注文を生成またはキャンセル。
栄養記録	メニュー項目の栄養情報を取得し、摂取量を記録、日次合計を表示。
時間指定リマインダー	デフォルトで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) で構築されています。

典型的なワークフロー

設定

マクドナルドとLuckin Coffeeのトークンはローカルの .env ファイルに保存されます。リポジトリには共有デモ認証情報を含む .env.trial が同梱されているため、独自のキーを提供せずにクエリ機能を試すことができます。
その他の設定（リマインダー時間、選択したスキン、UI設定）はペットのデータディレクトリに保存され、実行をまたいで保持されます。

現在のステータス

リリースバージョンは v0.1.0 (Python/Qt) です。Tauriベースのネイティブビルドとカスタム「オリジナル」キャラクターは初期M0開発段階です。
一部の高度なGIFベースのアニメーションには、追加のアセットをローカルにインポートする必要があります。基本的なzipにはコアとなる15のアニメーションアクションが含まれています。
注文機能はデモです。ペットは概要を表示して確認を求めますが、支払いは公式ブランドアプリで完了させる必要があります。

詳細情報

McPetは、遊び心のあるデスクトップマスコットと、実用的なAIエージェント監視および日常の利便性サービスを融合させた、マシン上でLLMを稼働させる開発者向けのツールです。