Chirak Mcp

io.github.ufhouck由 GitHub 帳號 ufhouck 發布v1.1.2更新於 Oct 24, 2026

Model Context Protocol (MCP) Server for Chirak Sales & Inventory Assistant

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

一個本機 MCP 伺服器，將 AI 助理連接到 Chirak 銷售、庫存與訂單 API，用於查詢、交易和業務報表。

可以做什麼
列出、搜尋、建立、更新和刪除商品，並依入庫、出庫、盤點、損耗等異動類型調整庫存。查詢銷售與訂單，記錄或作廢銷售交易，並取得包含營收、利潤和熱銷商品的每日彙總。查詢、新增、更新和刪除客戶紀錄，包括欠款餘額和購買彙總。列出、取得、建立和刪除發票、收據、退貨單和報價單，並將單據轉為可列印的熱感小票文字。
適用情境
適合 Chirak 店家經營者或員工透過 Claude Desktop、Cursor、Windsurf 等聊天用戶端向助理詢問庫存、銷售或客戶狀況，或讓助理記錄銷售、開立發票和調整庫存。
執行需求
透過 npm 套件 chirak-mcp 以 stdio 在本機執行，需要 Node.js 18.0.0 或以上版本。必須在 CHIRAK_API_KEY 環境變數中提供 Chirak API 金鑰，該金鑰在 Chirak iOS/iPadOS 應用程式的 Integrations & AI 中產生。選用變數 CHIRAK_API_BASE_URL 可覆寫預設的 Chirak Cloud API 位址。需要能連線至 Chirak API 的網路。
安裝前請注意
伺服器持有可存取店家資料的有效 Chirak API 金鑰（CHIRAK_API_KEY），請勿放入共用設定檔。許多工具會寫入或刪除資料，包括記錄和作廢銷售、調整庫存，以及建立或永久刪除商品、客戶和發票。業務與客戶資料會透過 TLS 傳送至 Chirak Cloud API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Chirak Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Chirak MCP Server

[Smithery] [npm version] [MCP Registry] [Glama]

A Model Context Protocol (MCP) server that connects AI clients (Claude Desktop, Cursor, Windsurf) to the Chirak Sales, Inventory, and Order Management API.

Overview

The Chirak MCP server enables Large Language Model (LLM) interfaces to perform real-time inventory lookups, record sales transactions, manage product records, and query business analytics via standard Model Context Protocol tooling over STDIO.

Prerequisites

  • Node.js 18.0.0 or higher
  • A Chirak API key (generated from the Chirak iOS/iPadOS application under Settings > Integrations & AI)

Installation and Configuration

Smithery (Automatic Installation)

To install Chirak for Claude Desktop automatically using Smithery:

bash
npx -y smithery mcp add ufhouck/chirak

Claude Desktop (Manual Configuration)

Add the following configuration to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "chirak": {      "command": "npx",      "args": ["-y", "chirak-mcp"],      "env": {        "CHIRAK_API_KEY": "your_api_key_here"      }    }  }}

Cursor and Windsurf

Configure the MCP server within your editor's MCP settings:

  • Command: npx
  • Arguments: -y chirak-mcp
  • Environment Variables:
    • CHIRAK_API_KEY: your_api_key_here

Smithery

To install via Smithery CLI:

bash
npx -y smithery mcp add ufhouck/chirak

Environment Variables

VariableRequiredDescription
CHIRAK_API_KEYYesAuthentication key for Chirak Cloud API (chk_live_...).
CHIRAK_API_BASE_URLNoTarget API endpoint (default: https://chirak.app/api/v1).

Tools

Inventory and Products

ToolDescription
get_productsList and search inventory items with optional filters by category, stock level, or query string.
add_productCreate a new product entry with SKU, name, prices, barcode, and initial stock.
update_stockAdjust inventory counts with specified movement type (inbound, outbound, audit, loss).
update_productModify existing product attributes such as title, price, or category.
delete_productRemove an inventory item record.

Sales and Orders

ToolDescription
get_salesRetrieve recent orders and sales records filtered by date or status.
record_saleCreate a sales transaction with line items, applied payment methods, and customer association.
cancel_saleVoid a sales transaction and automatically return items to inventory.
get_daily_summaryRetrieve daily aggregated metrics including total revenue, profit, transaction count, and top-selling products.

Customer Management

ToolDescription
get_customersQuery customer records, outstanding balances, and purchase summaries.
add_customerCreate a new customer profile.
update_customerUpdate contact information and customer notes.
delete_customerRemove a customer record.

Documents & Invoices (Billing)

ToolDescription
list_documentsRetrieve invoices, receipts, return invoices, and quotes with type/status filters.
get_documentFetch full itemized document details, customer details, and tax/VAT calculations.
create_documentCreate and issue formal invoices, sales receipts, or quotes with line items.
delete_documentPermanently remove an invoice or receipt record.
export_document_textRender formatted ASCII thermal receipt / ticket layout suitable for printing or chat display.

Development

Clone the repository and install dependencies:

bash
git clone https://github.com/ufhouck/chirak-mcp.gitcd chirak-mcpnpm installnpm run build

To run locally using STDIO:

bash
export CHIRAK_API_KEY="your_api_key_here"node dist/index.js

Security

  • All API communications are conducted over TLS (HTTPS).
  • API credentials are authenticated server-side using SHA-256 hash matching.
  • Requests operate strictly within isolated tenant database partitions.

Privacy Policy

Chirak values developer and user privacy. When interacting with this MCP server:

  • All data transmission between AI clients and Chirak Cloud API is encrypted in transit using TLS.
  • Store database partitions are strictly multi-tenant isolated by tenant ID.
  • API keys are verified server-side using SHA-256 hashes and are never stored in plain text.
  • Full Privacy Policy documentation: https://chirak.app/privacy

License

MIT License. See LICENSE for details.

來源：README.md，提交 4b7366b

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分