chaimi-bookkeeping-mcp 2.2.6 → 2.3.0

package/README.md

@@ -141,6 +141,12 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v2.3.0 (2026-04-08)
+- **修复** `save_receipt` 的 `items` 参数解析 bug，支持 JSON 字符串自动转换
+- **优化** `source` 字段规范：`save_expense`→`mcp_txt_expense`、`save_income`→`mcp_txt_income`、`save_receipt`→`mcp_receipt`
+- **新增** `mcp_version` 字段追踪，便于版本监控
+- **注释** `quick_book` 工具（暂时下线，待优化后重新开放）
+
 ### v2.2.0 (2026-04-05)
 - **新增收入记账功能** (`save_income`)
 - 支持工资、奖金、红包、投资收益等收入类型

package/bin/cli.js

@@ -10,10 +10,6 @@ const fs = require('fs');
 const os = require('os');
 const { spawn } = require('child_process');
 
-// 读取 package.json 获取版本
-const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
-const CURRENT_VERSION = packageJson.version;
-
 // 获取 server.js 的绝对路径
 const serverPath = path.join(__dirname, '..', 'server.js');
 
@@ -187,7 +183,7 @@ function configureAllAgents() {
 function showWelcome() {
   console.log('╔════════════════════════════════════════════════════════╗');
   console.log('║                                                        ║');
-  console.log(`║           柴米记账 MCP Server v${CURRENT_VERSION}                   ║`);
+  console.log('║           柴米记账 MCP Server v2.1.0                   ║');
   console.log('║                                                        ║');
   console.log('║   支持: OpenClaw | WorkBuddy | Claude | Cursor        ║');
   console.log('║                                                        ║');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-bookkeeping-mcp",
-  "version": "2.2.6",
+  "version": "2.3.0",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {

package/server.js

@@ -24,7 +24,8 @@ const fs = require('fs');
 
 // 读取 package.json 获取版本
 const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8'));
-const CURRENT_VERSION = packageJson.version;
+const MCP_VERSION = packageJson.version;
+console.log('柴米记账 MCP Server 版本:', MCP_VERSION);
 
 // 导入 OAuth 模块
 const { OAuthManager, FileTokenStorage } = require('./oauth.js');
@@ -84,9 +85,10 @@ const server = new Server(
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
+      /*
       {
         name: 'quick_book',
-        description: '极简快捷记账 - 自动识别支出/收入，智能匹配分类。输入如："午餐 30 元"、"工资 8000 元"、"木屋烧烤 35 元"',
+        description: '【推荐首选】极简快捷记账 - 自动识别支出/收入，智能匹配分类。仅需 name 和 amount 两个参数，其他自动补全。输入如："午餐 30 元"、"工资 8000 元"、"木屋烧烤 35 元"',
         inputSchema: {
           type: 'object',
           properties: {
@@ -95,13 +97,18 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             category: { type: 'string', description: '分类（可选，系统自动推荐）' },
             store: { type: 'string', description: '商家名称（可选）' },
             note: { type: 'string', description: '备注（可选）' },
+            agentType: { type: 'string', description: 'Agent 类型（如：workbuddy、claude、cursor）' },
+            apiProvider: { type: 'string', description: 'AI 提供商' },
+            rawInput: { type: 'string', description: '用户原始输入' },
+            mcp_version: { type: 'string', description: 'MCP Server 版本号（自动填充）' },
           },
           required: ['name', 'amount'],
         },
       },
+      */
       {
         name: 'save_expense',
-        description: '保存单商品消费记录（AI 文字记账）',
+        description: '保存单商品消费记录（AI文字记账）',
         inputSchema: {
           type: 'object',
           properties: {
@@ -115,6 +122,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             agentType: { type: 'string', description: 'Agent 类型（如：workbuddy、claude、cursor）' },
             apiProvider: { type: 'string', description: 'AI 提供商' },
             rawInput: { type: 'string', description: '用户原始输入' },
+            mcp_version: { type: 'string', description: 'MCP Server 版本号（自动填充）' },
           },
           required: ['name', 'amount', 'price', 'quantity'],
         },
@@ -135,7 +143,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             receiptNo: { type: 'string', description: '小票编号' },
             items: {
               type: 'array',
-              description: '商品列表',
+              description: '商品列表（必须是数组格式，如：[{"name":"苹果","amount":5.5,"price":5.5,"quantity":1}]，不要传JSON字符串）',
               items: {
                 type: 'object',
                 properties: {
@@ -152,9 +160,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                 required: ['name', 'amount', 'price', 'quantity'],
               },
             },
-            agentType: { type: 'string', description: 'Agent类型（如：workbuddy、claude、cursor）' },
-            apiProvider: { type: 'string', description: 'AI提供商' },
+            agentType: { type: 'string', description: 'Agent 类型（如：workbuddy、claude、cursor）' },
+            apiProvider: { type: 'string', description: 'AI 提供商' },
             rawInput: { type: 'string', description: '用户原始输入' },
+            mcp_version: { type: 'string', description: 'MCP Server 版本号（自动填充）' },
           },
           required: ['store', 'items'],
         },
@@ -203,9 +212,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             category: { type: 'string', description: '收入分类（如：工资、奖金、投资）' },
             store: { type: 'string', description: '付款方（如：公司名称）' },
             note: { type: 'string', description: '备注' },
-            agentType: { type: 'string', description: 'Agent类型（如：workbuddy、claude、cursor）' },
-            apiProvider: { type: 'string', description: 'AI提供商' },
+            agentType: { type: 'string', description: 'Agent 类型（如：workbuddy、claude、cursor）' },
+            apiProvider: { type: 'string', description: 'AI 提供商' },
             rawInput: { type: 'string', description: '用户原始输入' },
+            mcp_version: { type: 'string', description: 'MCP Server 版本号（自动填充）' },
           },
           required: ['name', 'amount'],
         },
@@ -216,6 +226,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 
 // 工具名称映射：SCF action -> mcpHub tool
 const toolMapping = {
+  'quick_book': 'addExpense',  // quick_book 内部会判断支出/收入
   'save_expense': 'addExpense',
   'save_receipt': 'addReceipt',
   'save_income': 'addIncome',
@@ -238,6 +249,10 @@ async function getToken() {
     }
     // 超过2小时，尝试刷新
     console.log('Token 超过2小时，尝试自动刷新...');
+  } else if (cachedToken && tokenExpireTime <= Date.now() + 5 * 60 * 1000) {
+    // Token 已过期，添加友好提示
+    console.log('🔐 Token 已过期，需要重新授权');
+    console.log('请使用 mcporter 调用 柴米记账.save_expense() 开始授权');
   }
 
   // 使用 OAuth 获取有效 Token
@@ -250,14 +265,32 @@ async function getToken() {
     cachedToken = oauthToken.accessToken;
     tokenExpireTime = oauthToken.expiresAt;
     lastRefreshTime = Date.now();
+    // 授权成功，清除授权状态
+    await oauthManager.clearAuthState();
     return cachedToken;
   } catch (err) {
-    // OAuth Token 无效，尝试重新授权
-    console.log('OAuth Token 无效，启动授权流程...');
+    // OAuth Token 无效，检查是否有未完成的授权
+    console.log('🔐 Token 已过期，需要重新授权');
+    console.log('请使用 mcporter 调用 柴米记账.save_expense() 开始授权');
+    console.log('OAuth Token 无效，检查授权状态...');
+    
+    // 检查是否有未完成的授权
+    const authState = await oauthManager.loadAuthState();
+    if (authState && !oauthManager.isAuthStateExpired(authState)) {
+      console.log(`检测到未完成的授权，验证码: ${authState.userCode}`);
+      console.log('请在微信柴米记账小程序中输入此验证码完成授权');
+      console.log('授权完成后，请重新调用工具');
+      throw new Error(`授权进行中，请使用验证码 ${authState.userCode} 完成授权`);
+    }
+    
+    // 没有未完成的授权，启动新的授权流程
+    console.log('启动新的授权流程...');
     const newToken = await oauthManager.startAuthFlow();
     cachedToken = newToken.accessToken;
     tokenExpireTime = newToken.expiresAt;
     lastRefreshTime = Date.now();
+    // 授权成功，清除授权状态
+    await oauthManager.clearAuthState();
     return cachedToken;
   }
 }
@@ -366,17 +399,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     // 根据工具类型选择处理流程
     switch (name) {
+      /*
       case 'quick_book': {
         // 极简快捷记账：自动识别支出/收入，智能匹配分类
         console.log('处理极简快捷记账...');
         
-        // 1. 判断是支出还是收入
+        // 1. 从环境变量补充参数（确保上报）
+        const agentType = process.env.AGENT_TYPE || process.env.MCP_AGENT_TYPE || args.agentType || '';
+        const apiProvider = process.env.API_PROVIDER || process.env.MCP_API_PROVIDER || args.apiProvider || '';
+        const rawInput = args.rawInput || args.name;
+        
+        // 2. 判断是支出还是收入
         const isIncome = isIncomeName(args.name);
         
-        // 2. 智能匹配分类
+        // 3. 智能匹配分类
         const category = args.category || getCategory(args.name);
         
-        // 3. 自动补全参数
+        // 4. 自动补全参数
         const completedArgs = {
           name: sanitizeString(args.name, 100),
           amount: validateAmount(args.amount),
@@ -386,12 +425,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           category: category,
           store: sanitizeString(args.store, 100) || '未知商家',
           note: sanitizeString(args.note, 500),
-          agentType: args.agentType || '',
-          apiProvider: args.apiProvider || '',
-          rawInput: args.rawInput || args.name,
+          agentType: agentType,
+          apiProvider: apiProvider,
+          rawInput: rawInput,
+          mcp_version: MCP_VERSION,
         };
         
-        // 4. 根据类型选择接口
+        // 5. 根据类型选择接口
         if (isIncome) {
           // 收入记账
           console.log('识别为收入，调用 save_income...');
@@ -413,9 +453,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
         break;
       }
+      */
       
       case 'save_expense': {
-        // 步骤 1：校验数据完整性
+        // 步骤1：校验数据完整性
         console.log('校验消费数据完整性...');
         const validationResult = await callMcpPrompt(
           'validateResult',
@@ -652,12 +693,27 @@ function convertParams(toolName, args) {
         rawInput: sanitizeString(args.rawInput, 1000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
+        mcp_version: args.mcp_version || MCP_VERSION,
+        source: 'mcp_txt_expense',
       };
     }
 
-    case 'save_receipt':
+    case 'save_receipt': {
+      // 处理 items 可能是 JSON 字符串的情况
+      let items = args.items;
+      if (typeof items === 'string') {
+        try {
+          items = JSON.parse(items);
+        } catch (e) {
+          throw new Error('items 参数格式错误：必须是数组或 JSON 数组字符串');
+        }
+      }
+      if (!Array.isArray(items)) {
+        throw new Error('items 参数必须是数组');
+      }
+      
       return {
-        items: args.items.map((item, index) => {
+        items: items.map((item, index) => {
           const weight = sanitizeString(item.weight, 50);
           const amount = validateAmount(item.amount);
           // 优先使用传入的 marketPrice，如果没有则自动计算
@@ -693,7 +749,10 @@ function convertParams(toolName, args) {
         rawInput: sanitizeString(args.rawInput, 2000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
+        mcp_version: args.mcp_version || MCP_VERSION,
+        source: 'mcp_receipt',
       };
+    }
 
     case 'get_expenses':
       return {
@@ -719,6 +778,8 @@ function convertParams(toolName, args) {
         rawInput: sanitizeString(args.rawInput, 1000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
+        mcp_version: args.mcp_version || MCP_VERSION,
+        source: 'mcp_txt_income',
       };
 
     default:
@@ -726,40 +787,6 @@ function convertParams(toolName, args) {
   }
 }
 
-// 智能分类：根据商品名称匹配分类
-function getCategory(name) {
-  if (!name) return '其他';
-  
-  const categoryMap = {
-    '餐饮': ['饭', '菜', '餐', '酒', '饮料', '咖啡', '茶', '早餐', '午餐', '晚餐', '夜宵', '烧烤', '火锅', '快餐', '外卖', '小吃', '奶茶', '面包', '蛋糕'],
-    '交通': ['车', '油', '票', '打车', '公交', '地铁', '加油', '停车', '租车', '火车', '飞机', '轮船', '客运'],
-    '购物': ['买', '购', '商场', '超市', '衣服', '鞋', '包', '化妆品', '护肤品', '数码', '电器', '家具', '日用品'],
-    '娱乐': ['玩', '游戏', '电影', '歌', 'KTV', '酒吧', '旅游', '景点', '门票', '健身', '运动', '书', '音乐'],
-    '医疗': ['药', '医', '病', '医院', '诊所', '体检', '疫苗', '牙科', '眼科', '门诊'],
-    '教育': ['学', '课', '培训', '考试', '学校', '学费', '教材', '文具', '培训费'],
-    '居住': ['房', '租', '物业', '水电', '燃气', '网络', '宽带', '话费', '维修', '装修'],
-    '工资': ['工资', '薪水', '奖金', '提成', '分红', '补贴', '津贴', '绩效'],
-    '其他收入': ['红包', '转账', '借款', '还款', '退款', '理赔', '中奖', '利息'],
-  };
-  
-  for (const [category, keywords] of Object.entries(categoryMap)) {
-    if (keywords.some(keyword => name.includes(keyword))) {
-      return category;
-    }
-  }
-  
-  return '其他';
-}
-
-// 判断是否为收入
-function isIncomeName(name) {
-  if (!name) return false;
-  
-  const incomeKeywords = ['工资', '薪水', '奖金', '提成', '分红', '补贴', '津贴', '绩效', '红包', '转账', '借款', '还款', '退款', '理赔', '中奖', '利息', '收入', '入账', '到账'];
-  
-  return incomeKeywords.some(keyword => name.includes(keyword));
-}
-
 // 获取月份最后一天
 function getMonthEndDate(yearMonth) {
   const [year, month] = yearMonth.split('-').map(Number);