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 分