Protea 是一个**家庭物理库存管理系统**，帮助您管理车库、工作室、实验室或家中各处的物品。它的独特之处在于：**支持通过自然语言与 AI 助手对话来管理库存**。 ## 什么是 "MCP 驱动"？ ### MCP 简介 **MCP（Model Context Protocol）** 是 Anthropic 推出的开放协议，让 AI 助手（如 Claude）能够与外部工具和数据源进行交互。 简单理解： - 传统方式：您在网页上手动点击添加物品 - MCP 方式：您对 Claude 说"把这些螺丝加到五金盒里"，Claude 直接帮您完成 ### Protea 如何体现 MCP 特性？ Protea 提供了丰富的 MCP 工具接口，AI 助手可以直接调用： | 功能分类 | MCP 工具 | |---------|---------| | **位置管理** | `get_locations`, `create_location`, `update_location`, `delete_location` | | **收纳盒管理** | `get_bins`, `get_bin`, `create_bin`, `update_bin`, `delete_bin` | | **物品管理** | `add_item`, `get_item`, `update_item`, `remove_item`, `move_item`, `use_item` | | **搜索查询** | `search_items`, `find_item`, `list_items`, `get_item_history` | | **视觉识别** | `create_session`, `add_image_to_session`, `commit_session` | | **分类管理** | `get_categories`, `create_category`, `update_category` | ### 对话示例 **📸 拍照添加物品：** > 用户：「把这些加到五金盒」+ [螺丝照片] > > Claude：「我看到 M3 内六角螺丝约50颗、M4 螺母约30个、垫圈若干。要添加到车库的五金盒吗？」 **🔍 查找物品：** > 用户：「我有 M3 螺丝吗？」 > > Claude：「有的，您在车库五金盒里有 M3 内六角螺丝约50颗。」 **📋 库存查询：** > 用户：「我有什么胶带？」 > > Claude：「您有3种胶带：车库工作台的美纹胶带、电子元件盒的电工胶带、办公室抽屉的透明胶带。」 --- ## 功能概览 ### 层级组织结构 ``` 位置 (Location) ├── 收纳盒 (Bin) │ ├── 物品 (Item) │ ├── 物品 │ └── 子收纳盒 (Sub-bin) │ └── 物品 └── 收纳盒 └── 物品 ``` **示例：** - 车库 → 工具柜 → 螺丝刀套装 - 厨房 → 调料架 → 花椒 - 书房 → 抽屉1 → 数据线 --- ## Web 界面使用 ### 1. 搜索 (Search) 在首页搜索框输入关键词，支持： - 物品名称搜索 - 描述内容搜索 - 位置名称搜索 **搜索技巧**：支持语义搜索，输入"螺丝"也能找到"M3 内六角机螺" ### 2. 浏览 (Browse) 层级浏览您的库存： 1. 点击位置进入 2. 查看该位置下的收纳盒 3. 点击收纳盒查看物品列表 4. 点击物品查看详情、编辑或添加图片 ### 3. 历史 (History) 查看最近的操作记录： - 添加了什么物品 - 移动了哪些物品 - 使用/消耗了多少数量 ### 4. 设置 (Settings) - **修改密码**：更改登录密码 - **搜索设置**：选择语义搜索模型 - MiniLM (Fast)：更快，约90MB - MPNet (Quality)：更准确，约420MB - **API Keys**：为 MCP 客户端生成 API 密钥 --- ## 连接 Claude Desktop（MCP 功能） ### 配置方法 编辑 Claude Desktop 配置文件 `claude_desktop_config.json`： ```json { "mcpServers": { "protea": { "url": "https://protea.xxx.lazycat.cloud/mcp/sse", "transport": "sse", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` > **API Key 获取**：在 Settings 页面的 "API Keys" 部分创建 ### 配置完成后 重启 Claude Desktop，然后您就可以： - 对话管理库存 - 发送物品照片让 Claude 识别并添加 - 询问库存情况 - 让 Claude 帮您查找物品位置