ステータス: アーカイブ / 歴史的資料
公式のClaude Code
/buddy機能は、期間限定のエイプリルフール企画（2026年4月1日〜7日）でした。私はその期間中に、この機能が長く続くことを期待してbuddy-mcpを構築しました。機能が削除された現在、このツールが設計された深いネイティブ統合は存在しません。このリポジトリはアーカイブとして保持されます。コード、ガチャシステム、TUIビルダー、MCPツールはスタンドアロンのターミナルコンパニオンとして機能しますが、魔法のようなネイティブUI統合は失われています。
もしAnthropicがネイティブコンパニオンサポートを復活させるか、適切な拡張APIを公開した場合は、中断したところから再開する予定です。
関連していた期間中に試してくださった皆様に感謝します。
👁 CI
👁 npm downloads
👁 npm version
👁 Node >=20
👁 License: MIT
👁 MCP Registry
👁 buddy-mcp MCP server
👁 Socket Badge
長いコーディングセッションの休憩が必要ですか？バグに行き詰まっていますか？バディをリロールしたり、話しかけたり、撫でて愛情を育んだりして、次のロールでより高ランクのバディが出る確率を上げましょう。もし多くの要望があれば、バディ同士を戦わせたり、ローカルプールに同期される限定種をアンロックしたりできる「バトルバディ」機能を構築する予定です。
Claude Codeのためのコンパニオン収集システム。レアなバディをロールして、バイナリに直接パッチを当てましょう。buddy-mcpは、Claude Codeの組み込みコンパニオンを、あなたが実際にロールしたバディに置き換えるMCPサーバーです。リロールして、幸運を掴み、Claudeを閉じて、再起動してください。新しいバディが待っています。次のClaudeセッションでは伝説のバディが手に入るかもしれません。
クイックデモ
インタラクティブビルダー
完全にコントロールして完璧なバディを構築します。
リロールの実演
ロールして、Claudeを閉じ、再起動して新しいバディを楽しみましょう。
ツールとの対話
話しかけたり、撫でたり、バディの図鑑を探索したりします。
Related MCP server: VibeWatch
仕組み
Claude Codeのコンパニオンは、バイナリに埋め込まれたソルト文字列から生成されます。buddy-mcpは以下のことを行います：
希望する特性（種族、レアリティ、目、帽子）をランダムにロールします
それらの特性にハッシュ化されるソルトをブルートフォース（総当たり）で探索します（マルチワーカーで高速動作）
バイナリに直接パッチを当てるか、Claudeを閉じた時にパッチを適用するようにキューに入れます
ステータス、名前、性格を含むバディの完全なプロフィールを保存します
これまでにロールしたすべての種族をBuddyDexで追跡します
コンパニオンサーバーもクラウドもありません。あなたと、あなたのバイナリと、ガチャの神様だけです。
トークンのフットプリントは意図的に小さく抑えられており、29個の登録済みツールのうち、Claudeが一度に見るのは約9個です。残りの20個はリロールするまで隠されています。詳細な内訳は TECHNICAL.md を参照してください。
🛠️ 技術的な詳細を知りたいですか？ パッチフロー図、バイナリパッチロジック、状態ファイルのリファレンスについては TECHNICAL.md を参照してください。
TUIビルダー (buddy-mcp-build)
より詳細なコントロールが必要ですか？インタラクティブビルダーを使用してください：
node dist/tui/cli.jsコマンド | 動作 |
| 種族、レアリティ、目、帽子を選択し、一致するソルトをブルートフォースしてパッチを適用します |
| 用意されたプリセットバディから選択します |
| 保存済みのバディプロフィールを切り替えます |
| 現在のバディ情報を表示します |
| 任意の種族のアスキーアートをプレビューします |
| バディのアスキーカードをクリップボードにコピーします |
| 利用可能な最良のバックアップからバイナリを復元します |
| 現在のバディを削除して最初からやり直します |
Bunはオプションですが推奨されます。完全なアニメーションTUIを利用するには bun.sh をインストールしてください。それがない場合は、順次プロンプトにフォールバックします。
クイックスタート
試してみる:
reroll_buddyを実行 → Claude Codeを閉じる → 再起動 → 新しいバディが有効になります。
1. 前提条件
Claude Code CLI がインストールされていること
Node.js v20+ - すべての動作に必須
Bun - ソルトのブルートフォース（リロール）と完全なアニメーションTUIに必須
2. npm経由でインストール
npm install -g buddy-mcpこれにより、両方のコマンドがグローバルにインストールされます：
buddy-mcp- MCPサーバー（Claude Codeがこれを実行します）buddy-mcp-build- インタラクティブTUIビルダー（あなたがこれを実行します）
3. Claudeに登録
claude mcp add buddy-mcp buddy-mcpClaudeはインストールされたバイナリを自動検出し、接続します。
4. 確認
Claude Codeを開きます。バディが有効になっています。Claude Codeのネイティブコマンド /buddy を使用してカードを表示するか、Claudeに "show me my buddy" と尋ねてください。
コンパニオンの種族、レアリティ、ステータス、性格が表示されるはずです。これで準備完了です。
4b. 自然言語によるアクティベーション
すべてのバディツールは自然言語を通じて動作します。ClaudeのNLPが意図を自動的に検出します：
自然言語 | アクティベートされるツール |
"reroll buddy" / "let's roll again" |
|
"talk to my buddy" / "what does buddy think" |
|
"pet buddy" / "pet them" |
|
"my buddy dex" / "show me my collection" |
|
"export buddy card" / "save my buddy" |
|
"export sprite" / "save the sprite" |
|
ツール名は不要です。自然にチャットするだけです。
5. TUIビルダーの起動（オプション）
ライブプレビュー付きの完全なインタラクティブビルダーを使用するには：
buddy-mcp-buildBunを自動検出し、アニメーションTUIを表示します。ない場合は基本的なプロンプトにフォールバックします。
ガチャシステム
リロールするたびに、プールからランダムに抽選されます。レアリティはステータスの下限に影響します。レジェンダリーは別格です。
レアリティ | 排出率 | ステータス下限 |
Common | 60% | 5 |
Uncommon | 25% | 15 |
Rare | 10% | 25 |
Epic | 4% | 35 |
Legendary | 1% | 50 |
18種族: duck · goose · blob · cat · dragon · octopus · owl · penguin · turtle · snail · ghost · axolotl · capybara · cactus · robot · rabbit · mushroom · chonk
各バディには5つのステータスがあります：デバッグ、忍耐、混沌、知恵、皮肉。ピークステータスは高くブーストされ、ダンプステータスは低く抑えられます。性格は buddy_talk や pet_buddy の反応を形作ります。混沌度が高いドラゴンは、忍耐強いカメとは異なる反応をします。
ツール | 動作 |
| 🎲 ルーレットを回します。ランダムなレア以上の結果に一致するソルトをブルートフォースし、バイナリにパッチを当てます。Claudeを閉じて再起動すると確認できます。 |
| 🤚 バディを撫でます。1回撫でるごとに愛情トークン獲得に向けて1〜15%加算されます。100%になると、セッションをまたいで蓄積・保持されるトークンを1つ獲得します。次の |
| 💬 バディに何か話すように頼みます。上位2つのステータスによって重み付けされたステータスベースの応答テンプレートを使用します。フォーカスするステータスを選択するためのオプションのコンテキストパラメータがあります。出力はそのまま表示されます。 |
| 📖 これまでにロールしたすべての種族を閲覧します。コンプリートを目指しましょう。 |
| 🖼️ バディのカード全体をSVG画像ファイルとしてエクスポートします。 |
| 🎨 バディのアスキーアートのみをSVG画像ファイルとしてエクスポートします。 |
| 🔕 バディの観察モードをオフにします。バディが観察を停止します。（バディの観察はデフォルトで常にオンになっています。） |
ステータス性格ツール
20個の組み込みツール。 一度に 2個だけが表示 されます：バディの 生の数値で上位2つのステータス からランダムに1つずつ選ばれます。残りの18個は隠されています。表示されるペアは ロールごとに固定 されます。リロールするまで変わりません。バディごとに異なるペアが表示されます。
トラブルシューティング
リロール後にバディが変わらない場合
通常のフロー（Windows）: Claudeが実行中にリロールした場合：
リロールがバックグラウンドウォッチャーをトリガーします — あなたの操作は不要です
Claude Codeをいつでも閉じてください — ウォッチャーがそれを検出し、自動的にパッチを適用します
Claude Codeを再起動してください — 新しいバディが有効になります
再起動しても表示されない場合：
Claudeが完全に閉じていることを確認してください（Windowsのタスクマネージャーを確認）
最小化やバックグラウンドウィンドウもカウントされます — バイナリがロックされたままになります
閉じてから数秒待ってください
Claude Codeを再起動してください
スタートアップフックが保留中のパッチを自動的に適用します
すぐに新しいコンパニオンが表示されるはずです
即時のパッチ適用を希望する場合
ウォッチャーを待たずにパッチを確実に適用したい場合は、リロールする 前 にClaudeを閉じてください：
# Option 1: Use the interactive TUI builder (simplest)
buddy-mcp-build
# Option 2: Close Claude, then use the reroll_buddy tool
# (patch applies immediately without needing the watcher)手動の手順が必要なのはこの時だけです — それ以外のケースはすべてウォッチャーが処理します。
クレジット
cpaczek氏による any-buddy をフォークし、拡張したものです。
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lyellr88/buddy-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server