Kumbaa

Kumbaa MCP 服务

在任何 AI 助手中访问您的家族档案。 Kumbaa 是一个供单个家庭使用的私人网站：记录家族树、家族成员的人生故事和老照片，只对该家庭邀请的亲属开放。将它连接到 Claude、ChatGPT 或任何支持 Model Context Protocol 的应用，即可询问家族相关信息、查看照片；如果您负责管理档案，还可以添加成员、将他们加入家族树、为照片添加说明和标签，以及邀请亲属。

https://kumbaa.app/mcp

这是一个托管的远程服务（Streamable HTTP）。无需安装，也不需要 API 密钥。首次使用工具时，您需要使用访问家族网站时所用的 Kumbaa 账号登录，并批准连接。一次连接即可访问您所属的所有家族档案，并按您在每个档案中的角色使用相应权限。

此代码库仅包含连接说明和配置，不包含 Kumbaa 服务及其服务端代码。

连接前的准备

您需要拥有一个 Kumbaa 账号，并且该账号已加入某个家族档案。请先使用邀请所用的电子邮件地址，在家族网站（<family>.kumbaa.app）上登录一次，或在 kumbaa.app 创建档案。随后，助手会以该账号的身份执行操作。如果您尚未完成此步骤，每个工具都会提示您先登录网站。

试着这样提问

• “我父亲那边的曾祖父母是谁？”
• “告诉我关于 Nani 的事：她什么时候出生，有哪些子女？”
• “找出 1965 年婚礼的照片，并说说照片里有哪些人。”
• “给我看看老家族宅邸的照片。”
• “添加我的表亲 Priya，她出生于 1990 年，是 Ravi 和 Meena 的女儿。”（策展人）
• “为这三张照片添加说明，并将它们放入 Diwali 相册。”（策展人）
• “邀请 [email protected] 以查看者身份加入家族。”（策展人）

连接

应用	方法
Claude（网页、桌面、移动端）	设置 → 连接器 → 添加自定义连接器 → https://kumbaa.app/mcp。分步说明：kumbaa.app/claude。
ChatGPT	使用上述 URL 将其添加为应用（需启用 Developer mode，适用于 Plus、Pro、Business、Enterprise 和 Edu）。分步说明：kumbaa.app/chatgpt。
Claude Code	执行 claude mcp add --transport http kumbaa https://kumbaa.app/mcp，然后运行 /mcp 登录。
VS Code（Copilot）	命令面板 → MCP: Add Server → HTTP → https://kumbaa.app/mcp，或将 clients/vscode-mcp.json 复制到 .vscode/mcp.json。
Gemini CLI	执行 gemini extensions install https://github.com/sanjaybhagia/kumbaa-mcp，然后运行 /mcp auth kumbaa。
Codex CLI	将 clients/codex-config.toml 添加到 ~/.codex/config.toml，然后运行 codex mcp login kumbaa。
Cursor	设置 → MCP → 添加服务，或将 mcp.json 复制到 ~/.cursor/mcp.json。请参阅身份验证详情。
Windsurf	将 clients/windsurf-mcp_config.json 添加到 ~/.codeium/windsurf/mcp_config.json。
其他应用	将其指向 https://kumbaa.app/mcp。对于只能运行本地（stdio）服务的应用，请参阅 llms-install.md。

工具

家庭中的所有成员都可以使用读取类工具。更改内容的工具仅供家庭所有者和管理员使用；查看者尝试使用时，会收到只有管理员才能使用的提示。

工具	功能
list_families	你所属的家庭档案、你在每个档案中的角色，以及当前选中的档案。
switch_family	将你另一个家庭档案设为当前档案。
list_people	家谱中的所有人，或匹配姓名的人，并显示日期、父母、伴侣和子女。
get_person	某人的个人资料：姓名、日期、地点、故事、家庭关系和照片。
list_albums	家庭的照片相册，以及年份和照片数量。
get_album	一个相册及其中的照片，并显示每张照片里的人。
find_photos	按说明文字、地点、人物或相册查找照片，或查找仍缺少详细信息的照片。
view_photo	查看一张照片，包括说明文字、年份、地点和照片中的人物。
add_person	将某人添加到家谱中。
update_person	更改某人的详细信息。
remove_person	从家谱中移除某人（其照片会保留）。操作前会询问确认。
link_people	添加或移除父母、子女、配偶或兄弟姐妹关系。移除前会询问确认。
update_marriage	更改婚姻的日期、地点和故事。
set_tree_start	设置家庭家谱打开时显示的人物。
set_portrait	将一张照片设为某人的肖像。
update_photo	更改照片的说明文字、年份、地点、相册或照片中的人物，或与家庭共享照片。
update_photos	一次对多张照片进行相同更改。
upload_photo	从图片 URL 或文件添加照片。除非立即共享，否则需等待管理员审核。
delete_photo	永久删除一张照片。操作前会询问确认。
save_album	创建或更改相册。
delete_album	删除相册；其中的照片会保留。操作前会询问确认。
list_members	查看家庭档案中的成员，以及已受邀的人。
invite_people	通过电子邮件邀请亲属，并设为查看者或管理员。
revoke_invitation	撤回尚未被接受的邀请。
change_member_role	将成员设为管理员或查看者。
remove_member	撤销某人的访问权限。操作前会询问确认。
rename_family	更改家庭档案的名称。

每个工具都有标题，并标注为只读或破坏性操作。移除人物、照片、相册、家庭关系或成员前，都需要获得对方明确同意，服务会要求助手先征得同意。移交所有权、删除家庭档案、备份和人脸检测只能在网站上进行。

隐私

每次调用都会根据你在当时对该家庭的成员身份进行检查，与网站上的检查完全相同。你不属于的家庭看起来与不存在的家庭相同。请参阅隐私政策。

套餐

家庭档案可免费使用 14 天，之后每个家庭每月收费 US$6.99，或每年收费 US$69。家庭邀请的所有成员均可免费加入。连接助手不额外收费。请参阅kumbaa.app/pricing。

身份验证详情

• OAuth 2.1，使用 PKCE（S256），面向公共客户端。授权服务器为 https://clerk.kumbaa.app（Clerk）。
• 客户端通过客户端 ID 元数据文档（CIMD， client_id_metadata_document_supported: true）标识自身。Claude、Claude Code 和 ChatGPT 使用该方式； VS Code 和 Gemini CLI 也表示支持。动态客户端注册也已启用 （registration_endpoint: https://clerk.kumbaa.app/oauth/register），供 Cursor、 mcp-remote 及其他仅使用此方式的应用使用。
• 发现：未经身份验证的请求会收到 401，并附带 WWW-Authenticate: Bearer resource_metadata="https://kumbaa.app/.well-known/oauth-protected-resource/mcp"。 另外还有 https://kumbaa.app/.well-known/oauth-protected-resource 和 https://kumbaa.app/.well-known/oauth-authorization-server。
• 访问令牌的受众严格为 https://kumbaa.app/mcp（aud 声明）。网站会话令牌 或面向任何其他地址的令牌都会被拒绝。
• 官方 MCP Registry 名称：app.kumbaa/kumbaa（server.json）。

链接

kumbaa.app · 功能 · Claude · ChatGPT · 定价 · 隐私 · 条款 · 支持 · [email protected]

由 Arigato Consulting Pty Ltd. 在悉尼打造。本仓库中的文件采用 MIT 许可； 详见 LICENSE。