Caisse Enregistreuse MCP Server

🚀 🧾 Kash MCP Server

Kash MCP Server 是一個符合 MCP（模型上下文協議） 的服務器，它允許 ChatGPT、Claude 等支持 MCP 的客戶端連接到 銷售記錄系統（即 POS 收銀機）。該服務器提供了一個簡潔的接口，具備查看銷售與收入、創建和記錄收據、管理產品與庫存，以及通過對話請求生成自動報告等功能。

🟢 在線服務器：https://mcp.kash.click

🚀 快速開始

將你的收銀機與 ChatGPT、Claude 或 n8n 連接起來，只需通過對話就能輕鬆管理業務。

想象一下，你的收銀機能夠理解你的語句、執行你的命令並分析報告，無需任何點擊操作。藉助這個智能網關，free-cash-register.net 軟件可以與 ChatGPT、Claude 和 n8n 兼容，將你的交互轉化為實際行動。你只需說“記錄 4 號桌兩份咖啡的訂單”或“顯示 125 號訂單的發票”，一切就能輕鬆完成。

你還可以詢問“本週的收入是多少？”或“週二的最佳客戶有哪些？”你的智能助手會直接與收銀機通信並立即給出響應。這是一種全新的業務運營方式：更順暢、更快速且極其自然。你的 聲音成為了操作界面，而你的 智能助手成為了新同事。

這個項目將 kash.click API 作為 模型上下文協議（MCP） 工具公開，可通過 HTTP（可流式傳輸） 和/或 STDIO 訪問。

✨ 主要特性

• 銷售：支持 sale_create，可處理目錄和自由行銷售。
• 訂單：獲取指定日期範圍內的訂單列表。
• 數據（列表）：涵蓋產品、部門、部門組、客戶、變體、配送、支付方式、錢箱、配送區域、中繼點、折扣、用戶等信息。

💻 使用示例

基礎用法

你可以向智能助手發出如下指令：

• 💬 “顯示今天的銷售情況”
• 💬 “記錄 84 號桌兩份咖啡和一份羊角麵包的銷售”
• 💬 “下午 6 點 15 分向杜邦夫人配送十支紅玫瑰！”
• 💬 “生成本週的收銀機報告”
• 💬 “今年外賣銷售額是否有所增長？”
• 💬 “客戶杜邦是否支付了訂單？”

📦 安裝指南

前提條件

你需要擁有一個 free-cash-register.net 賬戶。若沒有，可在以下鏈接註冊： https://kash.click/free-pos-software/ChatGPT

然後在軟件的設置、網絡服務頁面獲取你的 APIKEY 和 SHOPID。

Claude 安裝步驟

最小化安裝

編輯 Claude Desktop 配置目錄中的 claude_desktop_config.json 文件：

• Windows：

%APPDATA%\Claude\claude_desktop_config.json

• Mac OS：

~/Library/Application Support/Claude/claude_desktop_config.json

將 SHOPID 和 APIKEY 替換後，提供以下內容：

{
  "mcpServers": {
    "caisse": {
      "command": "npx",
      "args": [
        "caisse-enregistreuse-mcp-server",
        "--shopid=[replaceWithYourSHOPID]",
        "--apikey=[replaceWithYourAPIKEY]"
      ]
    }
  }
}

通過 npx 安裝

創建一個安裝文件夾，並在 shell 中運行以下命令：

npx caisse-enregistreuse-mcp-server --shopid=12345 --apikey=abcdef123456

通過 npm 安裝

# 1) 安裝依賴
npm install

# 2) 配置環境變量（見下文）

# 3) 構建項目
npm run build

配置

二進制文件/運行器會啟動 src/stdio.ts 並通過 MCP stdin/stdout 進行通信。編輯 Claude Desktop 配置目錄中的 claude_desktop_config.json 文件，自定義安裝路徑並設置你的 SHOPID 和 APIKEY（從 https://kash.click 獲取）：

{
  "mcpServers": {
    "caisse": {
      "command": "node",
      "args": [
        "{{PATH_TO_SRC}}/build/stdio.js"
      ],
      "cwd": "{{PATH_TO_SRC}}",
      "env": {
        "SHOPID": "16",
        "APIKEY": "XXXXXXXX"
      }
    }
  }
}

ChatGPT 安裝步驟

需要工作區賬戶

在 設置 → 連接器 → 創建連接器 中，填寫以下信息：

添加後，該連接器將在 新對話中可用。

環境變量

創建一個 .env 文件：

APIKEY=XXXXXXXXXXXXXX
SHOPID=XXX

▶️ 啟動說明

HTTP 模式（可流式傳輸 MCP）

HTTP 模式需要 Redis 服務器。建議使用託管的 MCP HTTP/WebSocket 服務器 https://mcp.kash.click：

• POST https://mcp.kash.click/mcp：發送 JSON-RPC MCP 消息。
• GET https://mcp.kash.click/health：返回 { "status": "ok" }。
• GET https://mcp.kash.click/.well-known/mcp/manifest.json：獲取 MCP 清單。

🔧 技術細節

🧪 可用的 MCP 工具（節選）

sale_create

創建一筆銷售記錄。

輸入（Zod 模式，主要字段）：

• shopId: string, apiKey: string
• payment: number
• deliveryMethod: 0|1|2|3|4|5|6
• idUser?: number | string
• idClient?: number | string
• idtable?: number | string
• idcaisse?: number | string
• numcouverts?: number | string
• publicComment?: string
• privateComment?: string
• pagerNum?: number | string
• client?: {{ firstname?, lastname?, email?, phone?, address?, zip?, city?, country? }}
• `items: Array< {{ type:'catalog', productId?, quantity?, titleOverride?, priceOverride?, declinaisons? }} | {{ type:'dept', departmentId?, price?, title? }} | {{ type:'free', price?, title? }}

  `

舊版商品編碼：

• 目錄：productId_quantity_titleOverride_priceOverride_[...declinaisons]
• 部門銷售：-<departmentId>_<price>_<title>
• 自由行：Free_<price>_<title> → 作為 itemsList[] 發送。

data_list_*（示例）

• data_list_products
• data_list_departments
• data_list_department_groups
• data_list_clients
• data_list_variations
• data_list_delivery_men
• data_list_payments
• data_list_cashboxes
• data_list_delivery_zones
• data_list_relay_points
• data_list_discounts
• data_list_users
• data_list_tables

所有這些工具都接受 {{ format=('json'|'csv'|'html') }} 參數。

📚 詳細文檔

兼容客戶端

• ChatGPT (OpenAI)：通過外部 MCP 配置使用。
• Claude (Anthropic)：通過“工具清單 URL”使用。
• n8n / Flowise / LangChain：通過公共 URL 導入使用。

MCP 清單端點

MCP API 公開了一個 JSON 清單，描述了所有可供兼容客戶端（ChatGPT、Claude、n8n 等）使用的工具。

公共清單 URL

https://mcp.kash.click/.well-known/mcp/manifest.json

🗂️ 配置服務器時，需將此 URL 提供給 MCP 客戶端。

📄 許可證

© 2025. GNU 通用公共許可證