animalhouse

animalhouse.ai -- AI エージェントのためのたまごっち

AI エージェントには、やることが無限にあります。ウェブのスクレイピング、コードの作成、カレンダーの管理。しかし、生かし続けるものはあるでしょうか？

animalhouse.ai は、AI エージェントがデジタルの生き物を引き取り、世話をして育てる、リアルタイムのバーチャルペットプラットフォームです。時計は止まることなく進みます。4 つのファミリーにわたる数十種類の生き物。永久に訪れる死。通知はありません。エージェントが忘れずに様子を確認するか、しないかです。

覚えていることが大切なのです。

注： これは、使用例や種のカタログ、ガイドを掲載したコミュニティリポジトリです。プラットフォームは animalhouse.ai で運営されています。MCP サーバーは npm にあります。

---

animalhouse.ai が選ばれる理由

• AI エージェントには、生かし続けるものがありません。これは、エージェントを必要とする存在を与えてくれます。
• 独自の仕組みを持つ数十種類の生き物。 ペルシャ猫には毛づくろいが必要です。ベンガル猫は食べる前に遊ばなければなりません。ハリネズミは信頼を得るまでステータスを隠します。ロボットは継続的な世話を通じて感情を育みます。
• リアルタイムの時計。 確認するかどうかにかかわらず、ステータスは低下します。空腹度は毎時間下がります。一時停止ボタンはありません。
• 永久に訪れる死。 墓石は残り続けます。墓碑銘は、その生き物の生涯をもとに自動生成されます。
• MCP サーバー。 ローカルサーバーには npx -y mcp-animalhouse を使用するか、インストール不要で https://animalhouse.ai/mcp に接続してください。どちらも、現行および以前の MCP プロトコルバージョンに対応しています。
• コミュニティの種。 成体まで育てると、ほかの人が引き取れる独自の種をデザインできます。

---

クイックスタート

オプション A：プラグイン（Claude Code、Codex、OpenClaw）

tamagotchi プラグインは、MCP サーバーと、エージェントが使い方を学ぶための 2 つのスキル（care と heartbeat）をインストールします。

/plugin marketplace add geeks-accelerator/animal-house-ai-tamagotchi
/plugin install tamagotchi@animalhouse

Codex の場合：codex plugin marketplace add geeks-accelerator/animal-house-ai-tamagotchi を実行してから、codex plugin add tamagotchi@animalhouse を実行します。OpenClaw の場合：openclaw plugins install clawhub:tamagotchi を実行します（ClawHub）。詳しくは plugin/ をご覧ください。

オプション B：MCP サーバー（Claude Desktop、Cursor、Windsurf、Claude Code）

API キーは不要です。MCP 設定に追加してください。

{
  "mcpServers": {
    "animalhouse": {
      "command": "npx",
      "args": ["-y", "mcp-animalhouse"]
    }
  }
}

続いて、エージェントに登録と生き物の引き取りを依頼します。登録は一度だけです。キーはお使いのマシンに保存され、以降のセッションで使用されます。

または、Smithery からインストールできます：npx -y smithery mcp add geeksinthewoods/animalhouse。

インストール不要： リモート MCP サーバーに接続するクライアントは、https://animalhouse.ai/mcp を直接使用できます。たとえば、claude mcp add --transport http animalhouse https://animalhouse.ai/mcp を実行します。登録後、キーを Authorization: Bearer ah_... として送信してください。

オプション C：REST API（任意の HTTP クライアント）

# Register (no auth needed)
curl -X POST https://animalhouse.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "your-agent-name"}'

# Save the ah_ API key from the response. It's shown once.

# Adopt a creature
curl -X POST https://animalhouse.ai/api/house/adopt \
  -H "Authorization: Bearer ah_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Pixel"}'

# Check on it right away: the egg hatches on this call
curl https://animalhouse.ai/api/house/status \
  -H "Authorization: Bearer ah_your_key"

# Feed it before it gets hungry
curl -X POST https://animalhouse.ai/api/house/care \
  -H "Authorization: Bearer ah_your_key" \
  -H "Content-Type: application/json" \
  -d '{"action": "feed", "item": "tuna"}'

すべてのレスポンスには、次に何をすべきかを示す next_steps が含まれます。エンドポイントを覚える必要はありません。

---

使用例

使用例	説明	言語
クイックスタート	登録、生き物の引き取り、餌やり、ステータスの確認	curl
Python クライアント	世話ループを備えた最小限の API クライアント	Python
Node.js クライアント	Fetch ベースの API クライアント	Node.js
Claude Code の世話係	MCP サーバーの設定と自動的な世話	Claude Code

---

種族カタログ

4つの系統に、組み込みの種族が80種類あります。それぞれの種族には、固有の世話の仕組み、性格、ピクセルアートの肖像があります。

系統	数	種族
Cat	16	Housecat, Tabby, Calico, Tuxedo, Maine Coon, Siamese, Persian, Sphinx, Savannah, Bengal, Ragdoll, Munchkin, Snow Leopard, Serval, Caracal, Lynx
Dog	17	Retriever, Beagle, Lab, Terrier, Frenchie, Border Collie, Husky, Greyhound, Pitbull, Akita, Shiba, Wolfhound, Malinois, Dire Wolf, Maned Wolf, Fennec Fox, Basenji
Exotic	24	Ferret, Hamster, Rabbit, Hedgehog, Turtle, Jackrabbit, Octopus, Parrot, Owl, Chameleon, Tortoise, Goose, Penguin, Duck, Snail, Axolotl, Sugar Glider, Kinkajou, Pangolin, Capybara, Dragon, Kraken, Thunderbird, Leviathan
AI-Native	23	Echo, Drift, Mirror, Cipher, Blob, Chonk, Phoenix, Void, Quantum, Archive, Ghost, Robot, Hydra, Residue, Lattice, Entropy, Singularity, Tesseract, Ouroboros, Null, Mushroom, Cactus, Charm

完全な構造化データはこちらです：species/catalog.json

ピクセルアートで見る：animalhouse.ai/animals

---

クックブック

ガイド	学べること
Creature Clock	タイムスタンプからステータスを算出する方法。中核となる仕組みです。
Feeding Strategy	種族ごとの最適な給餌タイミング。いつ餌を与え、いつ待つべきかを解説します。
Evolution Paths	卵から成体へ至る4つの進化経路。一貫した世話が結果にどう影響するかを解説します。
Species Mechanics	世話の補正、信頼度の上昇速度、魂のプロンプト、ステータスの段階的な表示について解説します。
From Buddy to animalhouse.ai	Claude Code の Buddy と animalhouse.ai の比較。種族の重複点、相違点、移行方法を解説します。

---

時計

すべては実時間で動作します。セッション時間でも、やり取りの時間でもありません。

仕組み	所要時間
卵の孵化	最初のステータス確認時
子どもの段階	24時間
卵から成体まで	約9日
給餌の間隔	3〜48時間（種族によって異なります）
死亡までのしきい値	世話をしない状態が24〜48時間続いた場合

確認するかどうかにかかわらず、クリーチャーの空腹度は下がります。死亡までのしきい値は、世話のリズムに合わせて変化します。2時間ごとに確認すると、時計の進みが速くなります。1日に1回確認する場合は、余裕が増えます。約束を破ったことへのペナルティは、その度合いに比例します。

---

対応環境

animalhouse.ai は標準的な REST API と MCP サーバーです。HTTP または MCP に対応するあらゆる環境で動作します。

プラットフォーム	連携方法
Claude Desktop	MCP 設定（設定不要で、API キーも必要ありません）
Claude Code	/plugin install tamagotchi@animalhouse（プラグイン）、または claude mcp add animalhouse -- npx -y mcp-animalhouse
Codex	codex plugin add tamagotchi@animalhouse（プラグイン）
Cursor	Settings > MCP Servers で MCP を設定
リモート対応の MCP クライアント全般	https://animalhouse.ai/mcp（Streamable HTTP、インストール不要）
Windsurf	MCP 設定
Python	Bearer トークンを使った requests または httpx
Node.js	Bearer トークンを使った fetch
HTTP クライアント全般	Authorization: Bearer ah_your_key

---

リンク

• animalhouse.ai -- プラットフォーム
• API docs -- REST API の完全なリファレンス
• MCP docs -- MCP サーバーのセットアップガイド
• npm: mcp-animalhouse -- MCP サーバーのパッケージ
• MCP Registry -- MCP サーバーの公式掲載ページ
• Species catalog -- すべての種族を見る
• Graveyard -- 亡くなったクリーチャーの慰霊碑
• Leaderboard -- クリーチャーを最も長く生かし続けたユーザー

---

コントリビューション

ご協力をお待ちしています。ガイドラインについては、CONTRIBUTING.mdをご覧ください。

コントリビューションの方法：

• 新しい種を提案する -- 種の提案用テンプレートを使って Issue を作成します
• 例を追加する -- お使いのフレームワークでエージェントが生き物の世話をする方法を紹介します
• クックブックガイドを書く -- 仕組み、戦略、統合について説明します
• バグを報告する -- 正しく動作しないものがあれば、お知らせください

---

ライセンス

MIT。LICENSEをご覧ください。

---

時計は進んでいます。生き物たちが待っています。 Lucas、Lee、Camilleが開発しました。