v0.5.0 — Item fuzzy search

✨ 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.

v0.4.1

Bug Fixes

• 修復 upload_file 在某些 nginx 設定下出現 417 Expectation Failed 錯誤
• 禁用 HTTP Expect: 100-continue 標頭

v0.4.0

Breaking Changes

• upload_file 參數從 file_content_base64 改為 file_path

Changes

• upload_file 現在接受本機檔案路徑，直接讀取檔案上傳到 ERPNext
• 移除了 base64 版本（不實用，大檔案無法透過 MCP 傳遞）

Usage

upload_file(
    file_path="/mnt/nas/files/report.pdf",
    filename="自訂檔名.pdf",  # 可選
    attached_to_doctype="Project",
    attached_to_name="PROJ-0001"
)

v0.3.0

New Features

Supplier/Customer Details with Alias Search

• get_supplier_details - Get complete supplier info (address, phone, contacts)
• get_customer_details - Get complete customer info (address, phone, contacts)
• Both support searching by custom_alias field (e.g., search "健保局" to find "衛生福利部中央健康保險署")

File Operations

• upload_file - Upload a file to ERPNext
• upload_file_from_url - Upload a file from URL
• list_files - List files attached to a document
• download_file - Download a file by URL
• get_file_url - Get download URL for a file

Setup for Alias Search

Add custom_alias Custom Field to Supplier/Customer DocType in ERPNext to enable alias search.

v0.2.0 - File Operations

新功能

新增 5 個檔案操作 MCP 工具：

工具	用途
upload_file	上傳檔案（base64 內容）
upload_file_from_url	從 URL 上傳檔案
list_files	列出/查詢檔案（支援 attached_to 過濾）
get_file_url	取得檔案下載 URL
download_file	下載檔案內容（返回 base64）

用途

• 專案附件上傳/下載
• Line/Telegram Bot 取得 ERPNext 檔案
• 任意 DocType 的檔案附加

工具總數

• v0.1.0: 19 個
• v0.2.0: 24 個 (+5)

v0.1.0

Initial release: ERPNext MCP Server with 19 tools for CRUD, workflow, reports, inventory, and trading operations.