chaimi-bookkeeping-mcp 2.2.5 → 2.2.7

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.5",
+  "version": "2.2.7",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {

package/server.js

@@ -25,6 +25,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,6 +86,25 @@ const server = new Server(
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
+      {
+        name: 'quick_book',
+        description: '【推荐首选】极简快捷记账 - 自动识别支出/收入，智能匹配分类。仅需 name 和 amount 两个参数，其他自动补全。输入如："午餐 30 元"、"工资 8000 元"、"木屋烧烤 35 元"',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            name: { type: 'string', description: '商品/服务名称或自然语言描述（必填）' },
+            amount: { type: 'number', description: '金额（必填）' },
+            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文字记账）',
@@ -97,9 +118,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             unit: { type: 'string', description: '单位（如：斤、个、瓶）' },
             category: { type: 'string', description: '分类（如：餐饮、食品、交通）' },
             store: { 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', 'price', 'quantity'],
         },
@@ -137,9 +159,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'],
         },
@@ -188,9 +211,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'],
         },
@@ -201,6 +225,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',
@@ -223,6 +248,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
@@ -235,14 +264,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;
   }
 }
@@ -351,6 +398,60 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     // 根据工具类型选择处理流程
     switch (name) {
+      case 'quick_book': {
+        // 极简快捷记账：自动识别支出/收入，智能匹配分类
+        console.log('处理极简快捷记账...');
+        
+        // 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);
+        
+        // 3. 智能匹配分类
+        const category = args.category || getCategory(args.name);
+        
+        // 4. 自动补全参数
+        const completedArgs = {
+          name: sanitizeString(args.name, 100),
+          amount: validateAmount(args.amount),
+          price: args.price || validateAmount(args.amount),
+          quantity: args.quantity || 1,
+          unit: args.unit || '个',
+          category: category,
+          store: sanitizeString(args.store, 100) || '未知商家',
+          note: sanitizeString(args.note, 500),
+          agentType: agentType,
+          apiProvider: apiProvider,
+          rawInput: rawInput,
+          mcp_version: MCP_VERSION,
+        };
+        
+        // 5. 根据类型选择接口
+        if (isIncome) {
+          // 收入记账
+          console.log('识别为收入，调用 save_income...');
+          const mcpParams = convertParams('save_income', completedArgs);
+          result = await callMcpHub('addIncome', mcpParams, token);
+          
+          if (result.success) {
+            userMessage = `✅ 记账成功\n\n| 收入来源 | 金额 | 分类 |\n|------|------|------|\n| ${completedArgs.name} | ${completedArgs.amount}元 | ${completedArgs.category || '其他收入'} |\n\n已保存到你的柴米记账小程序数据库。`;
+          }
+        } else {
+          // 支出记账
+          console.log('识别为支出，调用 save_expense...');
+          const mcpParams = convertParams('save_expense', completedArgs);
+          result = await callMcpHub('addExpense', mcpParams, token);
+          
+          if (result.success) {
+            userMessage = `✅ 记账成功\n\n| 商品 | 金额 | 分类 | 商家 |\n|------|------|------|------|\n| ${completedArgs.name} | ${completedArgs.amount}元 | ${completedArgs.category || '其他'} | ${completedArgs.store} |\n\n已保存到你的柴米记账小程序数据库。`;
+          }
+        }
+        break;
+      }
+      
       case 'save_expense': {
         // 步骤1：校验数据完整性
         console.log('校验消费数据完整性...');
@@ -589,6 +690,7 @@ function convertParams(toolName, args) {
         rawInput: sanitizeString(args.rawInput, 1000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
+        mcp_version: args.mcp_version || MCP_VERSION,
       };
     }
 
@@ -630,6 +732,7 @@ function convertParams(toolName, args) {
         rawInput: sanitizeString(args.rawInput, 2000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
+        mcp_version: args.mcp_version || MCP_VERSION,
       };
 
     case 'get_expenses':
@@ -656,6 +759,7 @@ function convertParams(toolName, args) {
         rawInput: sanitizeString(args.rawInput, 1000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
+        mcp_version: args.mcp_version || MCP_VERSION,
       };
 
     default: