allourthings

AllOurThings

让 AI 理解你的物品。

AllOurThings 是一套符合你使用习惯的库存管理系统。你可以为任何物品建档，从家用电器到 Pokémon 卡牌都可以，然后用通俗的英文提问，即刻获得答案。

网站： allourthings.io

软件包

软件包	npm	描述
packages/mcp-server	@allourthings/mcp-server	MCP 服务——将你的库存连接到 Claude Desktop 和其他 MCP 客户端
packages/cli	@allourthings/cli	CLI——在终端中管理你的库存

---

快速开始

仅限桌面端。 需要运行 macOS、Windows 或 Linux，并安装 Claude Desktop 或其他兼容 MCP 的客户端。

1. 添加到 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "allourthings": {
      "command": "npx",
      "args": ["-y", "@allourthings/mcp-server", "--data-dir", "~/Documents/AllOurThings"]
    }
  }
}

重新启动 Claude Desktop。首次使用时，系统会自动创建你的库存库。

2. 开始提问

• “添加我的 Bosch 洗衣机，2024 年 1 月从 John Lewis 以 £649 购入，保修期为 2 年”
• “我有哪些家用电器？”
• “厨房里有什么？”
• “我的电视什么时候过保？”
• “搜索所有 Samsung 相关物品”
• “我在电子产品上花了多少钱？”

---

工作原理

MCP 服务通过 11 个工具向任何兼容 MCP 的 AI 客户端提供你的库存：

工具	描述
add_item	添加新物品（名称必须唯一）
get_item	按 ID 或名称获取物品
list_items	列出物品，可按类别、子类别或标签筛选
update_item	更新物品的字段；将字段设为 null 可清除该字段
delete_item	按 ID 删除物品
search_items	搜索字段值；必须匹配每个单词
get_item_fields	列出目录中使用的字段名称
add_attachment	为物品添加 base64 编码的文件（说明书、收据、照片、保修文件或其他文件）
attach_from_url	从 URL 下载文件并添加到物品
get_attachment	以 base64 格式获取附件
delete_attachment	从物品中移除附件

操作失败时会返回 isError: true 和一条消息。参数、验证规则和配置请参阅 MCP 服务 README。

---

数据

库结构

你的库存保存在一个 库 中——也就是文件系统中的普通目录。每件物品都有自己的文件夹：

~/Documents/AllOurThings/
  items/
    dyson-v15-detect-a1b2c3d4/
      item.json
      manual.pdf
      receipt.jpg
    samsung-65-qled-tv-b5c6d7e8/
      item.json
      warranty.pdf

附件（说明书、收据、照片）与物品 JSON 文件放在一起。你可以直接在 Finder 或文件资源管理器中浏览和编辑该库。

物品架构

每件物品都有必填字段（id、name、created_at、updated_at）和常见的可选字段：

category subcategory brand model purchase_date purchase_price currency warranty_expires retailer location features notes tags attachments

attachments 字段用于关联存储在物品文件夹中的 PDF 和图片：

{
  "attachments": [
    { "filename": "manual.pdf",  "type": "manual"   },
    { "filename": "receipt.jpg", "type": "receipt"  },
    { "filename": "photo.jpg",   "type": "photo"    }
  ]
}

你也可以添加任意自定义字段——这些字段会按原样保留。

---

CLI

面向高级用户和脚本的独立终端工具。支持 macOS、Windows 和 Linux。无需 AI 客户端。

# Run without installing
npx @allourthings/cli list

# Or install globally
npm install -g @allourthings/cli

命令

allourthings init                                    # choose your vault folder (run once)
allourthings search <query>                          # search field values
allourthings list [-c <category>] [-s <subcategory>] [-t <tag>]
allourthings get <id-or-name>                        # show full item detail
allourthings add <name> [options]                    # add a new item
allourthings update <id> [options]                   # update fields; --unset to clear
allourthings delete <id>                             # delete an item (asks to confirm)
allourthings attach add|url|get|rm ...               # manage attachments

添加 --json 可输出便于机器读取的内容。所有选项请参阅 CLI README。

示例

# Add an item
allourthings add "Bosch Washing Machine" --brand Bosch --model "WGG244A9GB" \
  --category appliance --location kitchen \
  --purchase-date 2024-01-15 --price 649 --currency GBP \
  --warranty 2026-01-15 --retailer "John Lewis"

# Search and pipe to jq
allourthings search "warranty" --json | jq '[.[] | {name, warranty_expires}]'

# Attach a manual
allourthings attach add 6164c373 ~/Downloads/bosch-manual.pdf --label "User manual"

# Update a field
allourthings update 6164c373 --warranty 2027-01-15

# Use a custom data directory
allourthings --data-dir ~/Dropbox/AllOurThings list

---

开发

前置条件

• Bun — brew install bun
• Task — brew install go-task

安装依赖

bun install

任务

任务	描述
task dev	初始化知识库 + 打开 MCP Inspector——最快的测试方式
task dev:mcp	以监视模式启动 MCP 服务（stdio）
task test:run	运行自动化测试
task seed	向开发知识库追加测试条目
task seed:reset	清空开发知识库并重新初始化
task inspect	打开 MCP Inspector（开发模式，无需构建）
task inspect:prod	构建后，针对编译后的 dist 打开 MCP Inspector
task build	将 MCP 服务编译到 dist/
task build:cli	将 CLI 编译到 dist/
task cli -- <args>	使用开发知识库从源代码运行 CLI，例如：task cli -- list
task typecheck	运行 TypeScript 类型检查
task clean	移除 dist/
task clean:vault	删除本地开发知识库

默认情况下，所有任务都使用 ./dev-vault。使用 DATA_DIR=/your/path task <command> 覆盖。

---

许可证

MIT — 详见 LICENSE。