Repository avatar
AI Tools
v0.1.0
active

storewire-lite

io.github.trongio/storewire-lite

Demo Laravel store on Storewire Lite: search an outdoor gear catalog and read product details.

Documentation

Storewire Lite

Let AI assistants read your Laravel store's catalogue. Storewire Lite adds a read-only Model Context Protocol server to your app, built on the official laravel/mcp, with two tools:

ToolWhat a shopper's assistant gets
search_productsSearch by words or model number, category, brand, price range, in-stock only and spec filters; sorted; paged. Each hit is a product card (page URL, photo, price, stock line, key specs, category), plus the total, a link to the same results on your site, suggested filters and "did you mean" when nothing matched.
get_productOne product as its page shows it: photos, price, stock, the spec table, warranty, plain-text description, documents, the category trail, similar products and what goes with it. Found by id, URL, slug or model number.

You implement one interface over your own models. Nothing is written, nothing is ordered, nothing leaves your catalogue except what a visitor could already see.

Free and MIT licensed.

See the full Storewire running on a demo store: https://demo.plugins.hackerman.ge (point an assistant that supports remote MCP servers at https://demo.plugins.hackerman.ge/mcp).

Install

composer require hackerman/storewire-lite
php artisan vendor:publish --tag=storewire-lite-config

Requirements: PHP 8.3+, Laravel 12.41+ or 13, laravel/mcp 1.2+.

Connect your catalogue

Implement Hackerman\StorewireLite\Contracts\CatalogRepository and bind it:

use Hackerman\StorewireLite\Contracts\CatalogRepository;

$this->app->singleton(CatalogRepository::class, App\Mcp\MyCatalog::class);
interface CatalogRepository
{
    // An id from an earlier answer, a product URL or slug, a model number or SKU; null when nothing visible matches.
    public function resolve(string $reference, string $locale): ?string;

    // One product as its page shows it; null when a visitor may not see it.
    public function product(string $id, string $locale): ?ProductDetail;

    public function search(SearchQuery $query): SearchResult;
}

The data objects (ProductCard, ProductDetail, SearchQuery, SearchResult, Price, Availability and friends) are small readonly classes in Hackerman\StorewireLite\Data. Give each card its guest price; a card without one answers with the amount null.

Then switch the server on:

STOREWIRE_LITE_ENABLED=true
STOREWIRE_LITE_SERVER_NAME="Your Store"
STOREWIRE_LITE_CURRENCY=USD

It answers POST /mcp (Streamable HTTP, throttled per client) and runs over stdio with php artisan mcp:start storewire-lite. Try it:

curl -s http://localhost:8000/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-06-18' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"tent"}}}'

Configuration

config/storewire-lite.php: the switch, path, server name and instructions, currency, answer locales, your search page URL (search_url, with an optional {query} placeholder), the per-minute budget per client, and the answer size limits.

Storewire Lite or Storewire

Lite lets an assistant find and describe your products. Storewire lets it sell them: the shopper goes from a question to a filled cart on your own site without leaving the conversation.

Lite (free)Storewire
search_products, get_productyesyes
Cart handoff: cart_add_item, cart_update_item, cart_remove_item, cart_view, with a cart_url that opens your own cart page with the products in ityes
compare_products side by side, with the better value markedyes
check_compatibility (does this fit that, what goes with this)yes
list_categories, find_documents (manuals, datasheets)yes
get_store_info (stores, hours, payment, returns, FAQ) and get_delivery_options (fees, free-delivery threshold, same day)yes
Interactive widgets that draw product cards, comparisons and the cart inside the assistant (MCP Apps)yes
storewire:manifest: the app manifest assistant directories ask foryes
Response size budget, per-tool throttles, call metrics, translatable answers, your own tools on the same serveryes

Lite's CatalogRepository is a subset of Storewire's: same method signatures, same data objects. Upgrading means switching the namespace and adding the remaining methods; nothing you wrote for Lite is thrown away.

See it working and get Storewire at plugins.hackerman.ge.

Testing

composer test
composer analyse

License

MIT. See LICENSE.

No installation packages available.