chaimi-keep-mcp 3.3.2-beta.1 → 3.3.3-beta.1

package/bin/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * 柴米记账 MCP Server CLI 入口
+ * 柴米AI记账 MCP Server CLI 入口
  * 智能创建/更新多个 Agent 配置，保护用户已有配置
  */
 
@@ -20,7 +20,7 @@ const serverPath = path.join(__dirname, '..', 'server.js');
 // 默认的柴米记账配置
 const DEFAULT_CHAIMI_CONFIG = {
   command: 'chaimi-keep-mcp',
-  description: '柴米记账 MCP Server - 支持 AI 工具直接记账',
+  description: '柴米AI记账 MCP Server - 支持 AI 工具直接记账',
   env: {
     MCP_OAUTH_URL: 'https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpOAuth',
     MCP_HUB_URL: 'https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpHub-mcp',
@@ -38,6 +38,18 @@ const SUPPORTED_AGENTS = [
     configPath: path.join(os.homedir(), '.mcporter', 'mcporter.json'),
     format: 'json'
   },
+  {
+    name: 'OpenClaw MCP Config',
+    configPath: path.join(os.homedir(), '.openclaw', 'workspace', 'config', 'mcporter.json'),
+    format: 'json',
+    platform: 'darwin'
+  },
+  {
+    name: 'OpenClaw MCP Config (Linux)',
+    configPath: path.join(os.homedir(), '.openclaw', 'workspace', 'config', 'mcporter.json'),
+    format: 'json',
+    platform: 'linux'
+  },
   {
     name: 'WorkBuddy (Windows)',
     configPath: path.join(os.homedir(), 'workbuddy', 'mcp.json'),
@@ -297,7 +309,7 @@ function showWelcome() {
   
   console.error('+--------------------------------------------------------+');
   console.error('|                                                        |');
-  console.error('|          柴米记账 MCP Server v' + ver + '             |');
+  console.error('|          柴米AI记账 MCP Server v' + ver + '             |');
   console.error('|                                                        |');
   console.error('|   支持: OpenClaw/hermes/WorkBuddy 等国产小龙虾         |');
   console.error('|          Claude/Cursor 等支持 MCP 的 Agent             |');

package/config.example.yaml

@@ -1,4 +1,4 @@
-# 柴米记账 MCP Server 配置文件示例
+# 柴米AI记账 MCP Server 配置文件示例
 # 复制此文件为 config.yaml 并填入您的实际配置
 
 chaihuo:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.3.2-beta.1",
-  "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
+  "version": "3.3.3-beta.1",
+  "description": "柴米AI记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {
     "chaimi-keep-mcp": "bin/cli.js"
@@ -44,6 +44,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "chaimi-keep-mcp": "^3.3.2-beta.1",
     "dotenv": "^17.3.1",
     "node-fetch": "^2.7.0"
   },

package/server.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * 柴米记账 MCP Server (Node.js 版本)
+ * 柴米AI记账 MCP Server (Node.js 版本)
  * 适配微信云函数 mcpHub
  * 支持 Claude Desktop、Cursor、WorkBuddy、OpenClaw
  */
@@ -280,7 +280,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           type: 'object',
           properties: {
             store: { type: 'string', description: '商家名称（必填）' },
-            date: { type: 'number', description: '【必填】消费时间（毫秒级时间戳，13位数字。必须根据实际年月日时分秒计算，不允许复制示例数字）' },
+            date: { type: 'number', description: '消费时间（毫秒级时间戳，13位数字。如提供 date_components 可不传此字段）' },
+            date_components: { 
+              type: 'object', 
+              description: '【推荐】消费时间组件。包含：year、month、day、hour、minute、second。服务端会自动转换为时间戳'
+            },
             totalAmount: { type: 'number', description: '（必填）总金额（所有商品amount之和）' },
             originalAmount: { type: 'number', description: '（必填）应付金额（优惠前）' },
             discountAmount: { type: 'number', description: '（必填）优惠金额' },
@@ -1147,6 +1151,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
         
+        // 【新增】转换 date_components 为 date
+        if (processedArgs.date_components && !processedArgs.date) {
+          const { year, month, day, hour, minute, second } = processedArgs.date_components;
+          
+          // 校验时间组件完整性
+          if (!year || !month || !day || hour === undefined || minute === undefined) {
+            result = {
+              success: false,
+              error: 'date_components 不完整',
+              code: 400,
+              hint: '必须包含：year、month、day、hour、minute'
+            };
+            userMessage = '❌ 保存失败：时间信息不完整\n\n请确保 date_components 包含完整的年月日时分秒';
+            break;
+          }
+          
+          // 转换为时间戳
+          processedArgs.date = new Date(year, month - 1, day, hour, minute, second || 0).getTime();
+          console.log(`[save_receipt] 时间组件转换: ${JSON.stringify(processedArgs.date_components)} → ${processedArgs.date}`);
+        }
+        
         // P1: 日期合理性检查
         if (processedArgs.date) {
           const validation = validateDate(processedArgs.date, '小票日期');

package/utils/validators.js

@@ -44,6 +44,72 @@ function validateDate(dateInput, fieldName = '日期') {
   return { valid: true };
 }
 
+/**
+ * 校验时间组件合理性
+ * @param {Object} components - 时间组件对象
+ * @param {string} fieldName - 字段名称（用于错误提示）
+ * @returns {Object} { valid: boolean, error?: string, message?: string }
+ */
+function validateDateComponents(components, fieldName = '时间') {
+  if (!components || typeof components !== 'object') {
+    return {
+      valid: false,
+      error: '时间组件格式无效',
+      message: `❌ ${fieldName}组件必须是对象`
+    };
+  }
+
+  const { year, month, day, hour, minute, second } = components;
+
+  // 校验必填字段
+  const requiredFields = ['year', 'month', 'day', 'hour', 'minute'];
+  const missingFields = requiredFields.filter(f => components[f] === undefined || components[f] === null);
+  
+  if (missingFields.length > 0) {
+    return {
+      valid: false,
+      error: '时间组件缺少必填字段',
+      message: `❌ ${fieldName}组件缺少: ${missingFields.join(', ')}`
+    };
+  }
+
+  // 校验数值范围
+  if (year < 1965 || year > 2100) {
+    return { valid: false, error: '年份不合法', message: `❌ ${fieldName}年份必须在 1965-2100 之间` };
+  }
+  if (month < 1 || month > 12) {
+    return { valid: false, error: '月份不合法', message: `❌ ${fieldName}月份必须在 1-12 之间` };
+  }
+  if (day < 1 || day > 31) {
+    return { valid: false, error: '日期不合法', message: `❌ ${fieldName}日期必须在 1-31 之间` };
+  }
+  if (hour < 0 || hour > 23) {
+    return { valid: false, error: '小时不合法', message: `❌ ${fieldName}小时必须在 0-23 之间` };
+  }
+  if (minute < 0 || minute > 59) {
+    return { valid: false, error: '分钟不合法', message: `❌ ${fieldName}分钟必须在 0-59 之间` };
+  }
+  if (second !== undefined && (second < 0 || second > 59)) {
+    return { valid: false, error: '秒数不合法', message: `❌ ${fieldName}秒数必须在 0-59 之间` };
+  }
+
+  // 校验日期有效性（如 2025-02-30 是无效日期）
+  const testDate = new Date(year, month - 1, day);
+  if (testDate.getMonth() !== month - 1 || testDate.getDate() !== day) {
+    return { valid: false, error: '日期不存在', message: `❌ ${fieldName}日期不存在（如 2月30日）` };
+  }
+
+  // 校验不能是未来时间
+  const inputDate = new Date(year, month - 1, day, hour, minute, second || 0);
+  const now = new Date();
+  if (inputDate > now) {
+    return { valid: false, error: '不能是未来时间', message: `❌ ${fieldName}不能是未来时间` };
+  }
+
+  return { valid: true };
+}
+
 module.exports = {
-  validateDate
+  validateDate,
+  validateDateComponents
 };