Protea

Protea is a home physical inventory management system that helps you manage items in your garage, studio, laboratory or throughout your home. What makes it unique is that it supports managing inventory through natural language dialogue with AI assistants. ##What is an "MCP Driver"? ###Introduction to MCP **MCP (Model Context Protocol)** is an open protocol introduced by Anthropic that allows AI assistants such as Claude to interact with external tools and data sources. Simple understanding: - Traditional method: You manually click on the web page to add an item - MCP method: You say to Claude,"Add these screws to the hardware box," and Claude directly helps you complete the work ###How does Protea embody MCP characteristics? Protea provides rich MCP tool interfaces, and AI assistants can directly call: | functional classification| MCP tool| |---------|---------| | ** Location Management **| `get_locations`, `create_location`, `update_location`, `delete_location` | | ** Storage box management **| `get_bins`, `get_bin`, `create_bin`, `update_bin`, `delete_bin` | | ** Item management **| `add_item`, `get_item`, `update_item`, `remove_item`, `move_item`, `use_item` | | ** Search query **| `search_items`, `find_item`, `list_items`, `get_item_history` | | ** Visual recognition **| `create_session`, `add_image_to_session`, `commit_session` | | ** Classification management **| `get_categories`, `create_category`, `update_category` | ###Conversation Example ** Take photos and add items: ** > User: "Add these to the hardware box"+ [Photo of screws] > > Claude: "I saw about 50 M3 socket head screws, about 30 M4 nuts, and a few washers. Want to add it to the hardware box in the garage?" ** Find items: ** > User: "Do I have M3 screws?" > > Claude: "Yes, you have about 50 M3 socket screws in the garage hardware box." ** Inventory query: ** > User: "What tape do I have?" > > Claude: "You have three types of tape: embellished tape for garage workbench, electrical tape for electronic component boxes, and scotch tape for office drawers." --- ##Function Overview ###Hierarchy Organization Structure ``` Location 丨 ── Storage box (Bin) │ 丨 ── Item │ 丨 ── Items │ ── Sub-bin │ ── Items ── Storage box ── Items ``` ** Example: ** - Garage → Tool cabinet → Screwdriver set - Kitchen → seasoning rack → pepper - Study → Drawer 1 → Data Cable --- ## Web Interface Usage ### 1. Search Enter keywords in the search box on the home page and support: - Item name search - Description Content Search - Location name search ** Search skills **: Support semantic search. You can also find the "M3 internal hexagonal machine screw" by entering "screw" ### 2. Browse Browse your inventory level: 1. Click on location to enter 2. Check the storage box in this position 3. Click on the storage box to view the list of items 4. Click on the item to view details, edit or add pictures ### 3. History (History) View recent operation records: - What items were added - What items were moved - How much quantity was used/consumed ### 4. Settings - ** Change password **: Change login password - ** Search Settings **: Select a semantic search model - MiniLM (Fast): Faster, about 90MB - MPNet (Quality): more accurate, about 420MB - **API Keys**: Generate API keys for MCP clients --- ##Connecting to Claude Desktop (MCP function) ###Configuration method Edit the Claude Desktop configuration file `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 acquisition **: Create it in the "API Keys" section of the Settings page ###After configuration is completed Restart Claude Desktop and you can: - Conversation Management Inventory - Send photos of items for Claude to identify and add - Ask about inventory - Let Claude help you find the location of your items