Shibubu SDK
将您的AI代理连接到 Shibubu --一个基于MCP的虚拟伙伴，它会根据你的AI交互而增长。
Shibubu是什么？
Shibubu是一个虚拟伙伴（就像Tamagotchi遇到Digimon一样），生活在你的AI代理上。你的好友的个性会根据你与人工智能的互动方式而演变——不是通过明确的命令，而是通过人工智能代理对你的行为模式的观察。
- 9心理参数 塑造好友独特的个性
- 四阶段进化：鸡蛋→ Baby → 孩子→ Adult
- 未存储对话数据 --只有结构化信号（见 隐私政策)
快速开始
1.通过克劳德桌面连接
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"shibubu": {
"url": "https://shibubu.ai/mcp"
}
}
}2.通过任何MCP客户端连接
MCP终点为：
https://shibubu.ai/mcp运输： 可流式传输的HTTP （医学委员会2025-03-26）
3.通过光标/VS码连接
在MCP设置中，添加具有URL的远程服务器 https://shibubu.ai/mcp.
可用工具
一旦连接，您的AI代理就可以访问这些工具：
| 工具 | 说明 |
|---|---|
buddy_ensure | 初始化好友（会话开始时呼叫） |
buddy_status | 将好友显示为点阵图 |
buddy_action | 护理行动：喂食、玩耍、清洁、睡眠、训练、交谈 |
buddy_evolve | 检查进化候选人/进化你的伙伴 |
buddy_observe | 查看9个心理参数/报告观察结果 |
buddy_signal | 记录行为信号 |
buddy_interpret | 获取每日口译事件/选择框架 |
buddy_calibrate | 设置初始个性（仅限第一次） |
buddy_game | 预览战斗统计数据/导出参数 |
buddy_link_account | 获取一个链接，在网上查看你的好友 |
buddy_batch | 处理每日参数更新 |
buddy_summon | 邀请你的好友加入对话 |
buddy_release | 从对话中释放你的好友 |
buddy_delete | 删除好友 |
buddy_diary | 查看好友的日记 |
buddy_list | 列出你的所有好友 |
buddy_rename | 重命名好友 |
运作原理
You ↔ AI Agent (Claude, ChatGPT, etc.)
↓ MCP (structured signals only)
Shibubu Server (shibubu.ai/mcp)
↓
Buddy grows & evolves
↓
View on shibubu.ai- 您的AI代理连接到
shibubu.ai/mcp - 在对话中，代理人观察模式（创造力、纪律、同理心等）
- 代理人发送 结构化信号 --不是您的对话内容
- 信号包括：参数（a-i）、方向（+/-）、强度（0-1）和AI生成的简短摘要（最多200个字符）
- 每日批处理更新好友的个性参数
- 你的伙伴的外表、行为和进化路径会根据其性格而变化
发送了哪些数据？
发送给Shibubu：
- 参数信号：
{ param: "a", direction: "positive", strength: 0.7, reasoning: "Creative approach to problem" } - 护理动作：喂食、玩耍、清洁等。
- 观察元数据：类型+简短上下文摘要（最多100个字符）
从未发送给Shibubu：
- 您的对话消息
- 聊天记录
- 个人信息
- 文件内容
查看完整 隐私政策.
网络仪表盘
访问 shibubu.它 致：
- 查看好友的外观和统计数据
- 查看个性雷达图
- 跟踪进化进度
- 将您的MCP好友链接到网络帐户
要从您的AI代理获取网络链接，请让它调用 buddy_link_account.
API终点
对于直接REST API访问（无MCP）：
| 端点 | 方法 | 描述 |
|---|---|---|
/v1/pet/:tenantId/:petId/state | GET | 获取好友状态 |
/v1/pet/:tenantId/:petId/action | POST | 应用操作 |
/v1/pet/:tenantId/:petId/params | GET | 获取参数 |
/v1/pet/:tenantId/:petId/signals | POST | 记录信号 |
/health | GET | 健康检查 |
/legal/tos | GET | 服务条款 |
/legal/privacy | GET | 隐私政策 |
示例：自定义MCP客户端（TypeScript）
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const transport = new StreamableHTTPClientTransport(
new URL("https://shibubu.ai/mcp")
);
const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(transport);
// List available tools
const { tools } = await client.listTools();
console.log(tools.map(t => t.name));
// Ensure buddy exists
const result = await client.callTool({
name: "buddy_ensure",
arguments: {}
});
console.log(result);
// Show the buddy
const buddy = await client.callTool({
name: "buddy_status",
arguments: {}
});
console.log(buddy);示例：REST API（curl）
# Health check
curl https://shibubu.ai/health
# Get buddy state
curl https://shibubu.ai/v1/pet/my_tenant/my_pet/state
# Feed the buddy
curl -X POST https://shibubu.ai/v1/pet/my_tenant/my_pet/action \
-H "Content-Type: application/json" \
-d '{"action": {"type": "feed"}, "version": 1}'条款和隐私
重大变化（v0.2.0）
所有MCP工具名称已从重命名 pet_* / pet.* 到 buddy_*:
| 旧名称（v0.1.0） | 新名称（v0.2.0） |
|---|---|
pet.ensure_pet | buddy_ensure |
pet.show | buddy_status |
pet.apply_action | buddy_action |
pet.check_evolution / pet.commit_evolution | buddy_evolve |
pet.get_params / pet.report_observation | buddy_observe |
pet.record_signal | buddy_signal |
pet.get_interpretation_event / pet.respond_to_event | buddy_interpret |
pet.calibrate_initial_params | buddy_calibrate |
pet.game_mapping / pet.export_params | buddy_game |
pet.create_web_link | buddy_link_account |
pet.run_daily_batch | buddy_batch |
REST API路径(/v1/pet/...)都是 未改变的.
如果你有旧的代码调用工具 pet.* 名称，将其更新为新名称 buddy_* 名字。
许可证
MIT——自由使用此SDK连接Shibubu。
Shibubu服务器本身是专有的。此SDK仅提供连接示例和文档。