Skip to content

v0.5.0 — Item fuzzy search

Latest

Choose a tag to compare

@yazelin yazelin released this 25 May 03:21
ec30dc8

✨ Highlights

新增兩支模糊搜尋工具,解決「使用者用原廠型號(如 `KV-N40DT`)但系統 item_code 有公司前綴(如 `CTOS-KV-N40DT`)」時 AI 查不到庫存的問題。

🆕 New Tools

  • `find_items(keyword, item_group=None, brand=None, include_disabled=False, limit=20)`
    跨 `name` / `item_name` / `item_code` 做 `like %keyword%` 的 OR 模糊搜尋。
  • `get_item_details(name=None, keyword=None, warehouse=None, price_list=None)`
    一次回品項主檔 + 庫存 + 價格。仿 `get_supplier_details` 模式:`name` 直接 get → `keyword` 試精確 → fallback `find_items`。

🔧 Improvements

  • 強化 `get_stock_balance` / `get_item_price` / `get_stock_ledger` 的 docstring,明確說明「精確比對;空結果請改用 `find_items`」,引導 AI 不會誤判為零庫存。
  • 更新 `README.md` 與 `docs/api-reference.md`。

📦 Install

```bash
uvx erpnext-mcp@0.5.0

或在 .mcp.json 用 uvx erpnext-mcp(會抓最新版)

```

See PR #1 for full context.