Product Search Server

БесплатноНе проверен

An MCP server that exposes SF Supplies product search API to LLM tools. Supports free-text search, autocomplete suggestions, and retrieving filterable attribute

автор: sfsupplies

GitHub Embed

Описание

An MCP server that exposes SF Supplies product search API to LLM tools. Supports free-text search, autocomplete suggestions, and retrieving filterable attributes.

README

An MCP server that exposes the SF Supplies product search (the Typesense-backed website search API) to an LLM tool loop. It is a sibling of mssql-mcp-server and uses the same transport/auth/deploy pattern, so the internal chatbot can bridge both servers at once.

Tools

Tool	What it does
`search_products`	Runs a search against `POST /api/Products/Search/v2`. Supports free-text query, attribute `filters`, `category_slug`, sorting, and pagination. Returns each product's name, page URL, stock status, and attributes (Brand, Color, Size, Material, …).
`suggest_products`	Fast typeahead/autocomplete (`GET /api/Products/query?query=…`). Returns matching product names + URLs only — lightweight. Use it to resolve a vague/partial term, then hand the chosen term to `search_products`.
`list_product_filters`	Returns the facets (filterable attributes and their values + counts) available for a query/category — so the model knows what it can pass to `search_products`' `filters`.

The filters argument maps facet field names to arrays of values, matching the API's attributeFilter, e.g.:

{"Brand": ["Avery"], "Color": ["Plum"], "Size": ["15\" x 10 Yards"]}

Run locally (stdio — e.g. Claude Desktop)

pipenv install
pipenv run python -m product_search_mcp_server

Run as a shared HTTP service (LAN)

cp .env.deploy.example .env.deploy   # set MCP_AUTH_TOKEN (openssl rand -hex 32)
docker compose -f docker-compose.deploy.yml up -d --build

Consumers connect to http://<host>:8001/mcp with header Authorization: Bearer <MCP_AUTH_TOKEN>. Defaults to port 8001 to avoid clashing with the MSSQL MCP server on 8000.

examples/chatbot_bridge.py shows the client-side bridge the chatbot uses.

Configuration

Env var	Default	Purpose
`MCP_TRANSPORT`	`stdio`	`stdio` or `http`
`MCP_AUTH_TOKEN`	—	Required bearer token in `http` mode
`MCP_DISABLE_AUTH`	`false`	Dev-only: serve HTTP with no auth
`MCP_HTTP_HOST` / `MCP_HTTP_PORT`	`0.0.0.0` / `8000`	HTTP bind (container)
`SEARCH_API_URL`	`https://api.sfsupplies.com/api/Products/Search/v2`	Results/filtering endpoint
`SUGGEST_API_URL`	`https://api.sfsupplies.com/api/Products/query`	Typeahead/autocomplete endpoint
`PRODUCT_URL_TEMPLATE`	`https://www.sfsupplies.com/product/{slug}`	Product page link template — verify the path
`SEARCH_API_TIMEOUT`	`15`	HTTP timeout (seconds)
`SEARCH_API_KEY` / `SEARCH_API_KEY_HEADER`	—	Optional, only if the API gets locked down

from github.com/sfsupplies/internal-product-search-mcp-server

Установить Product Search Server в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install product-search-mcp-server

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add product-search-mcp-server -- uvx --from git+https://github.com/sfsupplies/internal-product-search-mcp-server product_search_mcp_server

FAQ