MCPet

MCPet

MCPet：AI時代の懐かしいバーチャルペット体験です！このModel Context Protocol（MCP）サーバーでは、自分だけのデジタルな仲間を迎え、世話をして、一緒に遊べます。ペットはあなたのお世話に応じて成長していきます。餌をあげたり、きれいにしたり、一緒にゲームをしたりして、赤ちゃんから大人へと成長する姿を見守りましょう。昔ながらのたまごっちのように、留守の間もペットのステータスは変化します。ただし、こちらはModel Context Protocolを通じて最新のAIを活用しています。今日からデジタルな友達を迎えましょう！

これは、バーチャルペットのシミュレーションシステムを実装したTypeScriptベースのMCPサーバーです。ペットのお世話や交流のためのツールを提供し、MCPの主要な概念を実演します。

機能

バーチャルペットの種類

• 4種類のペットから選べます：
  • Cat - 少し気難しいけれど、愛らしい
  • Dog - 元気いっぱいで、いつでも会えるのを喜んでくれる
  • Dragon - 個性的で情熱的な性格
  • Alien - 神秘的で好奇心旺盛

ペットのライフサイクル

• ペットが4つの段階を経て成長する姿を見守れます：
  • Baby - 小さくて、か弱い
  • Child - 成長中で、遊び好き
  • Teen - 活発で、発達中
  • Adult - 完全に成長し、賢い

ステータス管理

• 5つの主要なステータスを管理して、ペットのお世話をします：
  • Hunger - ペットに十分な食事を与えます
  • Happiness - ペットと遊んで、幸せな状態を保ちます
  • Health - ほかのステータスの影響を受ける全体的な健康状態
  • Energy - 活動すると減少し、休むと回復します
  • Cleanliness - 定期的にお風呂に入れて、ペットを清潔に保ちます

ツール

• create_pet - 名前と種類を指定して新しいペットを迎えます
• check_pet - ペットの現在の状態とステータスを確認します
• feed_pet - さまざまな種類の食べ物を与えます：
  • Snack - 空腹を少し満たします
  • Meal - バランスの取れた栄養を与えます
  • Feast - 最大限に食べさせます（ただし、健康に悪影響を及ぼすことがあります）
• play_with_pet - さまざまなゲームで遊びます：
  • Ball - 軽い運動
  • Chase - エネルギーをたくさん使う楽しい遊び
  • Puzzle - 頭を使う遊び
• clean_pet - ペットをお風呂に入れて、清潔さを回復します
• put_to_bed - ペットを寝かせて、エネルギーを回復させます

アニメーション

• ペットの種類や活動に応じた、動きのあるASCIIアートアニメーション
• ランダムなフレームによって、活気のある魅力的な体験を実現します
• 次のような特別なアニメーションがあります：
  • さまざまな食べ物を食べる
  • いろいろなゲームで遊ぶ
  • 入浴する
  • 眠る
  • 体調を崩す
  • など！

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

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

Inspectorを使うと、ペットとのやり取りを直接テストできるインターフェースが利用できます。

使用例

Claudeには、次のように質問できます：

• 「Whiskersという名前の猫のペットを作ってくれますか？」
• 「私のペットの調子はどうですか？」
• 「ペットに食事をあげてもらえますか？」
• 「ペットとかけっこをして遊びたいです」
• 「ペットが汚れているようです。お風呂に入れてくれますか？」
• 「ペットが疲れているようです。寝かせてくれますか？」