allourthings

AllOurThings

あなたの持ち物を、AIが理解します。

AllOurThingsは、あなたの使い方に合わせた在庫管理システムです。家電からポケモンカードまで、好きなものを何でも登録できます。あとは自然な英語で質問するだけで、すぐに回答が得られます。

ウェブサイト： allourthings.io

パッケージ

パッケージ	npm	説明
packages/mcp-server	@allourthings/mcp-server	MCP サーバー — 在庫をClaude Desktopやその他のMCPクライアントに接続します
packages/cli	@allourthings/cli	CLI — ターミナルから在庫を管理します

---

クイックスタート

デスクトップのみ。 Claude Desktopまたはその他のMCP対応クライアントを利用できるmacOS、Windows、Linuxが必要です。

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. 質問してみる

• 「2024年1月にJohn Lewisで£649で購入した、2年間の保証付きのBosch製洗濯機を追加して」
• 「所有している家電は何ですか？」
• 「キッチンには何がありますか？」
• 「テレビの保証はいつ切れますか？」
• 「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 を参照してください。