Hoardo

Hoardo MCP 服务

Hoardo 帮你追踪存放的物品：放在各个房间（地下室、阁楼、储物单元等）的编号箱子、每个箱子里的物品，以及你的打包、借出、出售、出租、待办和盘点清单。

Hoardo MCP 服务可以让 Claude、ChatGPT、Cursor 等 AI 应用使用你的 Hoardo。你可以询问帐篷在哪里、12 号箱里有什么，或让它把你的露营用品添加到打包清单中，答案都来自你自己的箱子。

此仓库仅包含文档和安装说明，不包含服务的源代码。该服务由 Hoardo 托管在下方所列地址。

服务

地址	https://www.hoardo.com/api/mcp
传输方式	Streamable HTTP
登录	使用你的 Hoardo 账号通过 OAuth 2.1 登录
注册表名称	com.hoardo/hoardo

登录

你的 AI 应用会通过 OAuth 帮你登录 Hoardo。Hoardo 使用 Supabase Auth 处理登录，应用会通过以下受保护资源元数据（RFC 9728）找到它： https://www.hoardo.com/.well-known/oauth-protected-resource/api/mcp。 应用会自行注册（动态客户端注册），因此无需复制客户端 ID 或密钥。登录 Hoardo 并点击“允许”后，应用便会以你的身份工作，并且只能访问你账号有权查看的内容。

你需要拥有 Hoardo 账号。请前往 hoardo.com 创建账号。

你连接的每个应用都会列在 Hoardo 的 设置 › 已连接的应用 中，你可以随时断开连接。

须知

• 更改会立即生效。 当你让 AI 应用添加、移动或更新内容时，Hoardo 会立即执行。此连接并非只读：你连接的应用既可以读取 Hoardo，也可以更改其中的内容。仅用于读取的工具会标记为 readOnlyHint，用于删除的工具会标记为 destructiveHint，因此会在操作前征求确认的应用可以据此提示你。
• 已删除的内容和箱子可通过 Hoardo 应用中的历史记录恢复。
• 无法通过 MCP 服务删除房间和整个清单。
• Hoardo 为你的物品生成的 AI 备注会保留在 Hoardo 中。 应用无法查看这些备注。

连接

Claude

1. 打开 设置 › 连接器，然后选择 添加自定义连接器。
2. 将其命名为 Hoardo，粘贴 https://www.hoardo.com/api/mcp，然后选择 添加。
3. 选择 连接，登录 Hoardo，然后选择 允许。

在 Claude Code 中：

claude mcp add --transport http hoardo https://www.hoardo.com/api/mcp

然后在 Claude Code 中运行 /mcp 并登录 Hoardo。

ChatGPT

自定义 MCP 服务可在网页版 ChatGPT 中使用，不能在移动应用中使用。哪些套餐可以添加此类服务，以及这些服务是否可以进行更改，由 OpenAI 决定。

1. 前往 插件，选择加号按钮，然后选择 添加自定义 MCP 服务。
2. 输入名称 Hoardo。在 连接 下粘贴 https://www.hoardo.com/api/mcp，然后选择 OAuth。
3. 接受警告，然后选择 创建为插件。
4. 安装插件，登录 Hoardo，然后选择 允许。在聊天中输入 @ 并选择 Hoardo。

Cursor

将 Hoardo 添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "hoardo": {
      "url": "https://www.hoardo.com/api/mcp"
    }
  }
}

打开 Cursor 设置 › MCP，选择 Hoardo 旁边的 连接（或 登录），登录 Hoardo，然后选择 允许。

其他应用

任何支持通过 Streamable HTTP 添加远程 MCP 服务并使用 OAuth 登录的应用都应该可以使用。将 https://www.hoardo.com/api/mcp 提供给应用，并在提示时登录。

工具

读取：仅查询信息。写入：更改内容。破坏性操作：删除内容，或造成不可挽回的损失。

工具	类型	功能
list_rooms	读取	列出你拥有或受邀加入的所有房间，以及每个房间中的箱子和物品数量。
search_items	读取	按多个搜索词查找你的物品，并显示每件物品的位置和所属清单。
get_inventory	读取	以精简形式获取你存放的所有物品（或单个房间中的物品），方便规划。
get_room	读取	获取一个房间中的箱子，以及每个箱子的编号、名称、位置和物品数量。
get_box	读取	获取一个箱子及其中的所有物品。
get_lists	读取	获取你的清单，以及每份清单的类型、物品数量和已勾选数量。
get_list_items	读取	获取某份清单上的内容，以及清单记录的每件物品信息。
get_rentals	读取	获取出租清单中的出租记录，以及物品在指定日期是否空闲。
add_items	写入	向箱子中添加物品，每次最多 50 件。
update_items	写入	更改物品的名称、数量、价格、备注、类别或日期。
move_items	写入	将物品移到其他房间中的箱子。
put_back_items	写入	将已取出的物品（打包、借出、出租）放回箱子。
add_box	写入	在房间中或另一个箱子内添加箱子；未指定编号时使用下一个可用编号。
update_box	写入	更改箱子的名称、编号或在房间中的位置。
move_boxes	写入	将箱子及其中的所有物品移到另一个房间或另一个箱子中。
add_room	写入	添加房间。
rename_room	写入	重命名房间。
create_list	写入	根据 Hoardo 中的物品、箱子或房间，以及按名称输入的物品创建清单。
add_to_list	写入	将物品、箱子或房间添加到现有清单。
update_list	写入	重命名清单、更改其类型或按钮文字，或将其发布到公开出售页面。
tick_on_list	写入	勾选清单上的物品（已打包、已归还、已售出、已完成或已盘点），或取消勾选。
update_list_entries	写入	记录清单中物品的信息：持有人、价格、到期日和押金。
count_on_list	写入	盘点清点清单上的物品。
use_counted_quantities	写入	将 Hoardo 中的数量设为盘点清单记录的数量。
book_rental	写入	立即出租或预约出租清单中的物品。
update_rental	写入	交出租赁物品、收回物品、延长租期、更改或取消租赁。
remove_from_list	破坏性操作	从清单中移除物品。仅存在于清单上的物品也会一并删除。
delete_items	破坏性操作	删除物品。可在 Hoardo 应用的历史记录中恢复。
delete_boxes	破坏性操作	删除箱子及其中的所有物品。可在 Hoardo 应用的历史记录中恢复。

完整列表及每个工具的输入架构见 https://www.hoardo.com/.well-known/mcp/server-card.json。 Hoardo 的 Server Card 见 https://www.hoardo.com/api/mcp/server-card。

帮助

• 将 Hoardo 连接到 AI 应用：hoardo.com/connect
• 问题与故障：hoardo.com/contact
• 隐私：hoardo.com/privacy-policy

许可证

本仓库中的文档采用 Creative Commons Attribution 4.0 International（CC BY 4.0）许可。Hoardo 名称、吉祥物和文字标识归 Hoardo 所有，不受此许可证涵盖。