chaimi-bookkeeping-mcp 2.2.7 → 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/package.json

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

package/server.js

@@ -24,7 +24,6 @@ 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);
 
@@ -86,6 +85,7 @@ const server = new Server(
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
+      /*
       {
         name: 'quick_book',
         description: '【推荐首选】极简快捷记账 - 自动识别支出/收入，智能匹配分类。仅需 name 和 amount 两个参数，其他自动补全。输入如："午餐 30 元"、"工资 8000 元"、"木屋烧烤 35 元"',
@@ -105,6 +105,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ['name', 'amount'],
         },
       },
+      */
       {
         name: 'save_expense',
         description: '保存单商品消费记录（AI文字记账）',
@@ -142,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: {
@@ -398,6 +399,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     // 根据工具类型选择处理流程
     switch (name) {
+      /*
       case 'quick_book': {
         // 极简快捷记账：自动识别支出/收入，智能匹配分类
         console.log('处理极简快捷记账...');
@@ -451,6 +453,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
         break;
       }
+      */
       
       case 'save_expense': {
         // 步骤1：校验数据完整性
@@ -691,12 +694,26 @@ function convertParams(toolName, args) {
         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，如果没有则自动计算
@@ -733,7 +750,9 @@ function convertParams(toolName, args) {
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
         mcp_version: args.mcp_version || MCP_VERSION,
+        source: 'mcp_receipt',
       };
+    }
 
     case 'get_expenses':
       return {
@@ -760,6 +779,7 @@ function convertParams(toolName, args) {
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
         mcp_version: args.mcp_version || MCP_VERSION,
+        source: 'mcp_txt_income',
       };
 
     default: