buddy-mcp

在漫长的代码编写过程中需要休息一下吗？被 Bug 卡住了？重新抽取一个伙伴，与他们交谈，或者通过抚摸他们来建立亲密度，从而提高下次抽取到更高级别伙伴的几率。如果需求足够多，我将开发“战斗伙伴”功能，你可以让你的伙伴与其他伙伴对战，并解锁可以同步回本地池的专属物种。

一个为 Claude Code 设计的“收集全部”伙伴系统。抽取稀有伙伴，直接将其打补丁到二进制文件中。buddy-mcp 是一个 MCP 服务器，它会用你实际抽取到的伙伴替换 Claude Code 内置的伙伴。重新抽取，碰碰运气，关闭 Claude，重新打开。你的新伙伴正在等你。你的下一次 Claude 会话可能就会获得传说级伙伴。

快速演示

交互式构建器

完全掌控，构建你完美的伙伴。

重新抽取演示

抽取，关闭 Claude，重新打开并享受你的新伙伴。

工具互动

交谈、抚摸并探索你的伙伴图鉴。

工作原理

Claude Code 的伙伴是由嵌入在二进制文件中的盐值字符串生成的。buddy-mcp 的做法是：

1. 随机抽取期望的特征（物种、稀有度、眼睛、帽子）

2. 暴力破解出一个哈希值为这些特征的盐值（多线程，运行速度快）

3. 原地修补二进制文件，或者在你关闭 Claude 时排队进行修补

4. 保存包含统计数据、名称和个性的完整伙伴档案

5. 在你的 BuddyDex 中追踪你抽取过的每一个物种

没有伙伴服务器。没有云端。只有你、你的二进制文件和扭蛋之神。

令牌占用量被刻意保持在很小的范围内，共 29 个注册工具，Claude 每次只会看到约 9 个。其余 20 个在重新抽取之前保持隐藏。查看 TECHNICAL.md 获取完整细分。

🛠️ 寻找技术深度解析？ 查看 TECHNICAL.md 获取补丁流程图、二进制修补逻辑和状态文件参考。

TUI 构建器 (buddy-mcp-build)

想要更多控制权？使用交互式构建器：

node dist/tui/cli.js

Bun 是可选的但推荐使用。安装 bun.sh 以获得完整的动画 TUI。没有它将回退到顺序提示。

快速入门

试一试： 运行 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-mcp

Claude 将自动检测已安装的二进制文件并连接它。

4. 验证

打开 Claude Code。你的伙伴已上线——使用 Claude Code 原生的 /buddy 命令查看你的卡片，或者问 Claude：“show me my buddy”

你应该能看到你伙伴的物种、稀有度、统计数据和个性。你已经成功了。

4b. 自然语言激活

所有伙伴工具都通过自然语言工作。Claude 的 NLP 会自动检测意图：

无需工具名称 —— 只需自然地聊天。

5. 启动 TUI 构建器（可选）

获取带有实时预览的完整交互式构建器：

buddy-mcp-build

自动检测 Bun 以获取动画 TUI。没有它将回退到基本提示。

扭蛋系统

每次重新抽取都是从池中进行的随机抽取。稀有度会影响统计数据的下限。传说级伙伴会有所不同。

18 种物种： 鸭子 · 鹅 · 斑点 · 猫 · 龙 · 章鱼 · 猫头鹰 · 企鹅 · 海龟 · 蜗牛 · 幽灵 · 美西螈 · 水豚 · 仙人掌 · 机器人 · 兔子 · 蘑菇 · 胖墩

每个伙伴有 5 项统计数据：调试、耐心、混乱、智慧、刻薄。峰值统计数据会被大幅提升，而最低统计数据则保持平庸。个性决定了 buddy_talk 和 pet_buddy 的响应方式。高混乱值的龙与耐心的海龟表现截然不同。

统计个性工具

20 个内置工具。 每次只有 2 个可见：从你伙伴的 原始值最高的前 2 项统计数据 中各随机挑选 1 个。其余 18 个保持隐藏。可见的这对工具是 每次抽取锁定的。在你重新抽取之前它不会改变。每个伙伴显示的组合都不同。

故障排除

重新抽取后伙伴没有改变

正常流程（Windows）： 当你重新抽取且 Claude 正在运行时：

1. 重新抽取会触发后台监视器 —— 你无需执行任何操作

2. 随时关闭 Claude Code —— 监视器会检测到它并自动应用补丁

3. 重新打开 Claude Code —— 你的新伙伴已上线

如果重新打开后没有出现：

1. 确认 Claude 已完全关闭（检查 Windows 任务管理器）

   • 即使是最小化或后台运行的窗口也算 —— 它们会锁定二进制文件

   • 关闭后等待几秒钟

2. 重新打开 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 分支并扩展。