chaimi-bookkeeping-mcp 3.0.3 → 3.1.1

package/README.md

@@ -70,9 +70,22 @@ MCP Server 会显示：
 
 ## 配置说明
 
-npm 全局安装时会**自动配置**，无需手动操作。
-
-如需手动配置（如从 GitHub 下载安装），参考 `~/.mcporter/mcporter.json` 格式。
+如果使用手动安装，需要配置 `~/.mcporter/mcporter.json`：
+
+```json
+{
+  "mcpServers": {
+    "柴米记账": {
+      "command": "chaimi-bookkeeping-mcp",
+      "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",
+        "MCP_PROMPT_URL": "https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpPrompt"
+      }
+    }
+  }
+}
+```
 
 ## 常见问题
 
@@ -128,27 +141,6 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
-### v2.3.4 (2026-04-08)
-- **简化** `save_expense` 工具，只保留 `name` 和 `amount` 为必填参数
-- **优化** 其他参数使用默认值，简化 Agent 调用
-
-### v2.3.3 (2026-04-08)
-- **修正** 版本号统一为 v2.3.3（包含 v2.3.2 的所有修复）
-
-### v2.3.2 (2026-04-08)
-- **修复** `server.js` 中 `CURRENT_VERSION` 未定义错误，统一使用 `MCP_VERSION`
-- **修复** 所有工具的 `userMessage` 添加默认值，防止显示 `undefined`
-
-### v2.3.1 (2026-04-08)
-- **修复** `bin/cli.js` 版本号显示问题，改为动态读取 package.json
-- **优化** OAuth 授权流程，轮询间隔缩短为 2 秒
-
-### 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/config.example.yaml

@@ -0,0 +1,15 @@
+# 柴米记账 MCP Server 配置文件示例
+# 复制此文件为 config.yaml 并填入您的实际配置
+
+chaihuo:
+  # JWT Token（从小程序调用 mcpAuth 云函数获取）
+  # 示例：token: "eyJhbGciOiJIUzI1NiIs..."
+  token: ""
+  
+  # SCF函数URL（部署后获取）
+  # 示例：base_url: "https://mcpServer-xxx.gz.apigw.tencentcs.com"
+  base_url: ""
+
+# 其他配置
+port: 3000
+environment: "production"

package/package.json

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

package/.env

@@ -1,6 +0,0 @@
-# OAuth 测试配置（临时，用于测试 OAuth 流程）
-# 注意：没有 MCP_TOKEN，强制使用 OAuth 授权
-
-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
-MCP_PROMPT_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpPrompt

package/.env.backup

@@ -1,5 +0,0 @@
-# /Users/solinxia/aider.git/caihuo_record_list/mcp-server-local/.env
-
-MCP_HUB_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpHub-mcp
-MCP_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcGVuaWQiOiJvaEM1eDNUdjRHLUxnVVdoWkJXWkhRNUg0UzRBIiwiaWF0IjoxNzc1MTEyNTc5LCJleHAiOjE3Nzc3MDQ1Nzl9.qmGS6eK9mwhFU7e---NlA7QvbcuRZqDsibkgYh74rGU
-MCP_OPENID=ohC5x3Tv4G-LgUWhZBWZHQ5H4S4A

package/.env.test

@@ -1,4 +0,0 @@
-# 测试环境配置
-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
-MCP_PROMPT_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpPrompt

package/.env.test-oauth

@@ -1,6 +0,0 @@
-# OAuth 测试配置（临时，用于测试 OAuth 流程）
-# 注意：没有 MCP_TOKEN，强制使用 OAuth 授权
-
-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
-MCP_PROMPT_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpPrompt

package/config.yaml

@@ -1,18 +0,0 @@
-# 柴米记账 MCP Server 配置文件
-# 请从小程序获取Token并填入下方
-
-chaihuo:
-  # JWT Token（从小程序调用 mcpAuth 云函数获取）
-  # 示例：token: "eyJhbGciOiJIUzI1NiIs..."
-  token: ""
-  
-  # SCF函数URL（部署后获取）
-  # 示例：base_url: "https://mcpServer-xxx.gz.apigw.tencentcs.com"
-  base_url: ""
-
-token: "FFeSVyBPLdnGNqaOP2NykCCyPU8ZLSKC6d5R2wkrwKo="      # ← 替换为从 mcpAuth 获取的 token
-base_url: "https://1412172089-4wbwsop8pe.ap-shanghai.tencentscf.com"      # ← 替换为 mcpServer 的 HTTP 触发地址
-
-# 其他配置保持不变
-port: 3000
-nvironment: "production"

package/requirements.txt

@@ -1,13 +0,0 @@
-# 柴米记账 MCP Server 依赖
-
-# MCP框架
-fastmcp>=0.4.0
-
-# HTTP请求
-requests>=2.31.0
-
-# YAML配置解析
-pyyaml>=6.0.1
-
-# 其他依赖
-urllib3>=2.0.0

package/server.py

@@ -1,763 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-柴米记账 MCP Server - V2版本
-使用 FastMCP 实现 MCP 协议服务
-架构：本地MCP Server -> 腾讯云SCF -> 微信云数据库
-
-支持两种记账场景：
-1. 单商品记账（AI文字）- save_expense
-2. 小票记账（多商品）- save_receipt
-"""
-
-import os
-import sys
-import json
-import yaml
-from typing import Optional, List, Dict
-from datetime import datetime
-
-from fastmcp import FastMCP
-import requests
-from requests.adapters import HTTPAdapter
-from urllib3.util.retry import Retry
-
-# 初始化 MCP Server
-mcp = FastMCP("chaihuo-mcp")
-
-# ==================== 配置管理 ====================
-
-class Config:
-    """配置管理类"""
-    
-    def __init__(self):
-        self.config_path = os.path.join(os.path.dirname(__file__), 'config.yaml')
-        self._config = self._load_config()
-    
-    def _load_config(self) -> dict:
-        """加载配置文件"""
-        default_config = {
-            'chaihuo': {
-                'token': '',           # JWT Token（从小程序获取）
-                'base_url': ''         # SCF函数URL
-            }
-        }
-        
-        if os.path.exists(self.config_path):
-            # 检查文件权限
-            self._check_file_permissions()
-            
-            try:
-                with open(self.config_path, 'r', encoding='utf-8') as f:
-                    config = yaml.safe_load(f)
-                    # 合并默认配置
-                    for key, value in default_config.items():
-                        if key not in config:
-                            config[key] = value
-                    return config
-            except Exception as e:
-                print(f"加载配置文件失败: {e}")
-        
-        return default_config
-    
-    def _check_file_permissions(self):
-        """检查配置文件权限，提醒用户设置合适的访问权限"""
-        try:
-            import stat
-            file_stat = os.stat(self.config_path)
-            mode = file_stat.st_mode
-            
-            # 检查是否对组或其他用户可读写
-            if mode & stat.S_IRWXG or mode & stat.S_IRWXO:
-                print(f"\n⚠️  安全提醒：")
-                print(f"   配置文件 {self.config_path} 的权限过于开放")
-                print(f"   建议执行以下命令保护您的Token：")
-                print(f"   chmod 600 {self.config_path}\n")
-        except Exception:
-            # 权限检查失败不影响主程序运行
-            pass
-    
-    @property
-    def token(self) -> str:
-        return self._config.get('chaihuo', {}).get('token', '')
-    
-    @property
-    def base_url(self) -> str:
-        return self._config.get('chaihuo', {}).get('base_url', '')
-    
-    def is_configured(self) -> bool:
-        """检查配置是否完整"""
-        return bool(self.token and self.base_url)
-
-
-# 全局配置对象
-config = Config()
-
-# ==================== HTTP Client ====================
-
-class SCFClient:
-    """腾讯云SCF HTTP客户端"""
-    
-    def __init__(self, base_url: str, token: str):
-        self.base_url = base_url.rstrip('/')
-        self.token = token
-        
-        # 创建session并配置重试
-        self.session = requests.Session()
-        retry_strategy = Retry(
-            total=3,
-            backoff_factor=1,
-            status_forcelist=[429, 500, 502, 503, 504],
-        )
-        adapter = HTTPAdapter(max_retries=retry_strategy)
-        self.session.mount("http://", adapter)
-        self.session.mount("https://", adapter)
-    
-    def _make_request(self, data: dict) -> dict:
-        """发送HTTP请求到SCF"""
-        url = self.base_url
-        
-        try:
-            response = self.session.post(
-                url,
-                json=data,
-                headers={
-                    'Content-Type': 'application/json',
-                    'Authorization': f'Bearer {self.token}'
-                },
-                timeout=30
-            )
-            response.raise_for_status()
-            return response.json()
-        except requests.exceptions.Timeout:
-            raise Exception("请求超时，请检查网络连接")
-        except requests.exceptions.ConnectionError:
-            raise Exception("连接失败，请检查SCF函数URL配置")
-        except requests.exceptions.HTTPError as e:
-            error_msg = f"HTTP错误: {e.response.status_code}"
-            try:
-                error_data = e.response.json()
-                if 'error' in error_data:
-                    error_msg = f"{error_msg} - {error_data['error']}"
-            except:
-                pass
-            raise Exception(error_msg)
-        except Exception as e:
-            raise Exception(f"请求失败: {str(e)}")
-    
-    # ===== 单商品记账 =====
-    def save_expense(self, data: dict) -> dict:
-        """调用mcpServer保存单个消费记录"""
-        return self._make_request({
-            'action': 'save_expense',
-            'data': data
-        })
-    
-    # ===== 小票记账 =====
-    def save_receipt(self, data: dict) -> dict:
-        """调用mcpServer保存小票及商品明细"""
-        return self._make_request({
-            'action': 'save_receipt',
-            'data': data
-        })
-    
-    # ===== 查询功能 =====
-    def get_expenses(self, params: dict = None) -> dict:
-        """调用mcpServer查询消费记录"""
-        return self._make_request({
-            'action': 'get_expenses',
-            'params': params or {}
-        })
-    
-    def get_receipt_list(self, params: dict = None) -> dict:
-        """调用mcpServer获取小票列表"""
-        return self._make_request({
-            'action': 'get_receipt_list',
-            'params': params or {}
-        })
-    
-    def get_receipt_detail(self, receipt_id: str) -> dict:
-        """调用mcpServer获取小票详情"""
-        return self._make_request({
-            'action': 'get_receipt_detail',
-            'params': {'receiptId': receipt_id}
-        })
-    
-    # ===== 统计功能 =====
-    def get_statistics(self, year_month: str, type: str = 'item') -> dict:
-        """调用mcpServer获取统计信息"""
-        return self._make_request({
-            'action': 'get_statistics',
-            'params': {'yearMonth': year_month, 'type': type}
-        })
-
-
-# 初始化客户端
-client = None
-if config.is_configured():
-    client = SCFClient(config.base_url, config.token)
-
-# ==================== MCP Tools - 单商品记账 ====================
-
-@mcp.tool()
-def save_expense(
-    name: str,
-    amount: float,
-    category: str,
-    store: str,
-    date: Optional[str] = None,
-    price: Optional[float] = None,
-    quantity: Optional[str] = None,
-    unit: Optional[str] = None,
-    agent_type: str = "workbuddy"
-) -> str:
-    """
-    保存单个消费记录（AI文字记账）
-    
-    适用场景：用户描述一笔消费，如"午餐35元麦当劳"
-    存储方式：直接保存到 receipt_items 表，不创建小票记录
-    
-    Args:
-        name: 商品/服务名称，如"午餐"、"牛奶"
-        amount: 总金额，如35.0、128.5
-        category: 分类，如"餐饮"、"购物"、"交通"
-        store: 商家名称，如"麦当劳"、"沃尔玛"
-        date: 消费时间，格式YYYY-MM-DD HH:mm:ss（可选，默认当前时间）
-        price: 单价（可选，默认等于amount）
-        quantity: 数量（可选，默认"1"）
-        unit: 单位（可选）
-        agent_type: MCP Agent类型（可选，默认workbuddy）
-    
-    Returns:
-        保存结果信息
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        # 构建数据
-        data = {
-            'name': name,
-            'amount': amount,
-            'price': price if price is not None else amount,
-            'quantity': quantity or '1',
-            'unit': unit or '',
-            'category': category,
-            'store': store,
-            'date': date or datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
-            'source': 'mcp_text',
-            'agentType': agent_type
-        }
-        
-        result = client.save_expense(data)
-        
-        if result.get('success'):
-            return json.dumps({
-                'success': True,
-                'message': f'✅ 记账成功！\n商品：{name}\n金额：{amount}元\n商家：{store}\n分类：{category}',
-                'data': result.get('data', {})
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '保存失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'保存异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-# ==================== MCP Tools - 小票记账 ====================
-
-@mcp.tool()
-def save_receipt(
-    store: str,
-    total_amount: float,
-    items: str,
-    date: Optional[str] = None,
-    receipt_no: Optional[str] = None,
-    payment_method: Optional[str] = None,
-    agent_type: str = "workbuddy"
-) -> str:
-    """
-    保存小票及商品明细（小票识别记账）
-    
-    适用场景：用户上传小票图片，识别出多个商品
-    存储方式：先创建 receipts 记录，再批量创建 receipt_items
-    
-    Args:
-        store: 商户名称，如"沃尔玛"、"永辉超市"
-        total_amount: 小票总金额
-        items: 商品列表JSON字符串，格式：[{"name":"牛奶","price":12.5,"quantity":"2","amount":25.0,"category":"食品"}]
-        date: 消费时间，格式YYYY-MM-DD HH:mm:ss（可选，默认当前时间）
-        receipt_no: 小票编号（可选）
-        payment_method: 支付方式，如"微信支付"、"支付宝"（可选）
-        agent_type: MCP Agent类型（可选，默认workbuddy）
-    
-    Returns:
-        保存结果信息
-    
-    Example:
-        items参数示例：
-        '[
-            {"name":"纯牛奶","price":12.5,"quantity":"2","amount":25.0,"category":"食品","unit":"盒"},
-            {"name":"面包","price":8.0,"quantity":"1","amount":8.0,"category":"食品","unit":"个"}
-        ]'
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        # 解析商品列表
-        try:
-            items_list = json.loads(items)
-            if not isinstance(items_list, list):
-                raise ValueError("items必须是数组")
-        except json.JSONDecodeError as e:
-            return json.dumps({
-                'success': False,
-                'error': f'商品列表JSON格式错误: {str(e)}'
-            }, ensure_ascii=False)
-        
-        if len(items_list) == 0:
-            return json.dumps({
-                'success': False,
-                'error': '商品列表不能为空'
-            }, ensure_ascii=False)
-        
-        # 构建数据
-        data = {
-            'store': store,
-            'totalAmount': total_amount,
-            'date': date or datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
-            'receiptNo': receipt_no or '',
-            'paymentMethod': payment_method or '',
-            'items': items_list,
-            'agentType': agent_type
-        }
-        
-        result = client.save_receipt(data)
-        
-        if result.get('success'):
-            item_count = result.get('data', {}).get('itemCount', 0)
-            return json.dumps({
-                'success': True,
-                'message': f'✅ 小票保存成功！\n商户：{store}\n总金额：{total_amount}元\n商品数：{item_count}个',
-                'data': result.get('data', {})
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '保存小票失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'保存小票异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-# ==================== MCP Tools - 查询功能 ====================
-
-@mcp.tool()
-def get_expenses(
-    start_date: Optional[str] = None,
-    end_date: Optional[str] = None,
-    category: Optional[str] = None,
-    type: str = "all",
-    limit: int = 10
-) -> str:
-    """
-    查询消费记录（支持单商品和小票商品）
-    
-    Args:
-        start_date: 开始日期，格式YYYY-MM-DD（可选）
-        end_date: 结束日期，格式YYYY-MM-DD（可选）
-        category: 分类筛选，如"餐饮"、"购物"（可选）
-        type: 记录类型，all（全部）/single（单商品）/receipt（小票商品），默认all
-        limit: 返回条数（可选，默认10条）
-    
-    Returns:
-        消费记录列表
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        params = {'limit': limit, 'type': type}
-        
-        if start_date:
-            params['startDate'] = start_date
-        if end_date:
-            params['endDate'] = end_date
-        if category:
-            params['category'] = category
-        
-        result = client.get_expenses(params)
-        
-        if result.get('success'):
-            data = result.get('data', {})
-            items = data.get('items', [])
-            total = data.get('total', 0)
-            
-            if total == 0:
-                return json.dumps({
-                    'success': True,
-                    'message': '暂无消费记录',
-                    'data': data
-                }, ensure_ascii=False)
-            
-            # 格式化输出
-            lines = [f"📊 共查询到 {total} 条记录\n"]
-            for i, item in enumerate(items, 1):
-                receipt_tag = "🧾" if item.get('receiptId') else "📝"
-                lines.append(f"{receipt_tag} {i}. {item.get('date', '')[:10]} | "
-                           f"{item.get('name', '')} | "
-                           f"¥{item.get('amount', 0)} | "
-                           f"{item.get('category', '')} | "
-                           f"{item.get('store', '')}")
-            
-            lines.append(f"\n📝 单商品 | 🧾 小票商品")
-            
-            return json.dumps({
-                'success': True,
-                'message': '\n'.join(lines),
-                'data': data
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '查询失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'查询异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-@mcp.tool()
-def get_receipt_list(limit: int = 10) -> str:
-    """
-    获取小票列表
-    
-    Args:
-        limit: 返回条数（可选，默认10条）
-    
-    Returns:
-        小票列表
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        result = client.get_receipt_list({'limit': limit})
-        
-        if result.get('success'):
-            data = result.get('data', {})
-            receipts = data.get('receipts', [])
-            total = data.get('total', 0)
-            
-            if total == 0:
-                return json.dumps({
-                    'success': True,
-                    'message': '暂无小票记录',
-                    'data': data
-                }, ensure_ascii=False)
-            
-            # 格式化输出
-            lines = [f"🧾 共查询到 {total} 张小票\n"]
-            for i, r in enumerate(receipts, 1):
-                lines.append(f"{i}. {r.get('date', '')[:10]} | "
-                           f"{r.get('store', '')} | "
-                           f"¥{r.get('totalAmount', 0)}")
-            
-            return json.dumps({
-                'success': True,
-                'message': '\n'.join(lines),
-                'data': data
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '获取小票列表失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'获取小票列表异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-@mcp.tool()
-def get_receipt_detail(receipt_id: str) -> str:
-    """
-    获取小票详情（包含商品明细）
-    
-    Args:
-        receipt_id: 小票ID
-    
-    Returns:
-        小票详情及商品明细
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        result = client.get_receipt_detail(receipt_id)
-        
-        if result.get('success'):
-            data = result.get('data', {})
-            receipt = data.get('receipt', {})
-            items = data.get('items', [])
-            
-            # 格式化输出
-            lines = [
-                f"🧾 小票详情",
-                f"商户：{receipt.get('store', '')}",
-                f"时间：{receipt.get('date', '')}",
-                f"总金额：¥{receipt.get('totalAmount', 0)}",
-                f""
-            ]
-            
-            if receipt.get('originalAmount'):
-                lines.append(f"原价：¥{receipt.get('originalAmount')}")
-            if receipt.get('discountAmount'):
-                lines.append(f"优惠：-¥{receipt.get('discountAmount')}")
-            if receipt.get('paymentMethod'):
-                lines.append(f"支付方式：{receipt.get('paymentMethod')}")
-            
-            lines.append(f"\n📦 商品明细（共{len(items)}个）：")
-            
-            for i, item in enumerate(items, 1):
-                lines.append(f"{i}. {item.get('name', '')} "
-                           f"¥{item.get('price', 0)} x {item.get('quantity', 1)} "
-                           f"= ¥{item.get('amount', 0)} "
-                           f"({item.get('category', '')})")
-            
-            return json.dumps({
-                'success': True,
-                'message': '\n'.join(lines),
-                'data': data
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '获取小票详情失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'获取小票详情异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-# ==================== MCP Tools - 统计功能 ====================
-
-@mcp.tool()
-def get_statistics(year_month: str, type: str = "item") -> str:
-    """
-    获取月度消费统计
-    
-    Args:
-        year_month: 年月，格式YYYY-MM，如"2026-03"
-        type: 统计类型，item（按商品统计）/receipt（按小票统计），默认item
-    
-    Returns:
-        月度消费统计信息
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        result = client.get_statistics(year_month, type)
-        
-        if result.get('success'):
-            data = result.get('data', {})
-            total_amount = data.get('totalAmount', '0')
-            total_count = data.get('totalCount', 0)
-            categories = data.get('categories', [])
-            stat_type = data.get('type', 'item')
-            
-            # 格式化输出
-            type_label = "商品" if stat_type == 'item' else "小票"
-            lines = [
-                f"📈 {year_month} 消费统计",
-                f"统计方式：按{type_label}统计",
-                f"总支出：¥{total_amount}",
-                f"数量：{total_count}个\n"
-            ]
-            
-            if categories:
-                lines.append("分类统计：")
-                for cat in categories:
-                    lines.append(f"  {cat.get('name', '')}: ¥{cat.get('amount', '0')} "
-                               f"({cat.get('count', 0)}个, {cat.get('percentage', '0')}%)")
-            
-            return json.dumps({
-                'success': True,
-                'message': '\n'.join(lines),
-                'data': data
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '获取统计失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'获取统计异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-# ==================== MCP Tools - 快速记账 ====================
-
-@mcp.tool()
-def quick_record(text: str, agent_type: str = "workbuddy") -> str:
-    """
-    快速记账 - 从自然语言描述中提取信息并保存（单商品）
-    
-    Args:
-        text: 消费描述，如"午餐35元麦当劳"、"昨天在沃尔玛买了128块钱的东西"
-        agent_type: MCP Agent类型（可选，默认workbuddy）
-    
-    Returns:
-        记账结果
-    """
-    try:
-        if not client:
-            return json.dumps({
-                'success': False,
-                'error': 'MCP Server未配置，请在config.yaml中设置token和base_url'
-            }, ensure_ascii=False)
-        
-        # 使用简单的规则提取
-        import re
-        
-        # 提取金额
-        amount_match = re.search(r'(\d+\.?\d*)\s*元?', text)
-        amount = float(amount_match.group(1)) if amount_match else 0
-        
-        # 提取商家（简单规则）
-        store_keywords = ['麦当劳', '肯德基', '沃尔玛', '家乐福', '星巴克', '瑞幸', '滴滴', '高德', '永辉', '盒马']
-        store = '未知商家'
-        for keyword in store_keywords:
-            if keyword in text:
-                store = keyword
-                break
-        
-        # 提取分类（简单规则）
-        category = '其他'
-        if any(kw in text for kw in ['午餐', '晚餐', '早餐', '吃饭', '餐厅', '麦当劳', '肯德基']):
-            category = '餐饮'
-        elif any(kw in text for kw in ['超市', '沃尔玛', '家乐福', '买东西', '永辉', '盒马']):
-            category = '购物'
-        elif any(kw in text for kw in ['打车', '滴滴', '地铁', '公交', '高德']):
-            category = '交通'
-        
-        # 提取商品名称
-        name = '消费'
-        if '午餐' in text:
-            name = '午餐'
-        elif '晚餐' in text:
-            name = '晚餐'
-        elif '早餐' in text:
-            name = '早餐'
-        
-        if amount <= 0:
-            return json.dumps({
-                'success': False,
-                'error': '无法从描述中提取金额，请使用save_expense手动记账'
-            }, ensure_ascii=False)
-        
-        # 保存记录
-        data = {
-            'name': name,
-            'amount': amount,
-            'category': category,
-            'store': store,
-            'date': datetime.now().strftime('%Y-%m-%d %H:%M:%S'),
-            'source': 'mcp_text',
-            'agentType': agent_type
-        }
-        
-        result = client.save_expense(data)
-        
-        if result.get('success'):
-            return json.dumps({
-                'success': True,
-                'message': f'✅ 快速记账成功！\n描述：{text}\n解析：{name} ¥{amount} @ {store} ({category})',
-                'data': result.get('data', {})
-            }, ensure_ascii=False)
-        else:
-            return json.dumps({
-                'success': False,
-                'error': result.get('error', '保存失败')
-            }, ensure_ascii=False)
-            
-    except Exception as e:
-        return json.dumps({
-            'success': False,
-            'error': f'快速记账异常: {str(e)}'
-        }, ensure_ascii=False)
-
-
-# ==================== 主入口 ====================
-
-if __name__ == "__main__":
-    print("=" * 50)
-    print("柴米记账 MCP Server - V2")
-    print("支持场景：单商品记账 + 小票多商品记账")
-    print("=" * 50)
-    
-    if not config.is_configured():
-        print("\n⚠️  配置不完整，请检查 config.yaml：")
-        if not config.token:
-            print("   - 缺少 token（从小程序获取）")
-        if not config.base_url:
-            print("   - 缺少 base_url（SCF函数URL）")
-        print("\n配置文件位置:", config.config_path)
-        print("\n配置示例：")
-        print("""
-chaihuo:
-  token: "eyJhbGciOiJIUzI1NiIs..."  # 从小程序获取的JWT Token
-  base_url: "https://mcpServer-xxx.gz.apigw.tencentcs.com"
-""")
-    else:
-        print(f"\n✅ 配置完整")
-        print(f"SCF地址: {config.base_url}")
-        print(f"Token: {config.token[:20]}...")
-    
-    print("\n" + "=" * 50)
-    print("启动 MCP Server...")
-    print("=" * 50 + "\n")
-    
-    # 启动MCP Server
-    mcp.run()

package/test-mcp.sh

@@ -1,26 +0,0 @@
-#!/bin/bash
-
-# MCP Server 本地测试脚本
-
-echo "=== 柴米记账 MCP Server 本地测试 ==="
-echo ""
-
-# 设置环境变量（测试环境）
-export MCP_HUB_URL="https://chaihuo-xxx.ap-shanghai.app.tcloudbase.com/mcpHub-mcp"
-export MCP_PROMPT_URL="https://chaihuo-xxx.ap-shanghai.app.tcloudbase.com/mcpPrompt"
-export MCP_OAUTH_URL="https://chaihuo-xxx.ap-shanghai.app.tcloudbase.com/mcpOAuth"
-export AGENT_TYPE="test"
-export API_PROVIDER="test"
-
-echo "环境变量设置："
-echo "  MCP_HUB_URL: $MCP_HUB_URL"
-echo "  AGENT_TYPE: $AGENT_TYPE"
-echo "  API_PROVIDER: $API_PROVIDER"
-echo ""
-
-# 测试 MCP Server 启动
-echo "=== 测试 MCP Server 启动 ==="
-echo "按 Ctrl+C 停止测试"
-echo ""
-
-node server.js

package/test-parent-process.js

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-
-const { execSync } = require('child_process');
-const os = require('os');
-
-console.log('='.repeat(60));
-console.log('父进程信息检测工具');
-console.log('='.repeat(60));
-
-console.log('\n1. 当前进程信息:');
-console.log(`   PID: ${process.pid}`);
-console.log(`   父进程 PID (PPID): ${process.ppid}`);
-console.log(`   当前平台: ${process.platform}`);
-
-console.log('\n2. 尝试获取父进程信息:');
-
-if (process.platform === 'darwin' || process.platform === 'linux') {
-  try {
-    const psOutput = execSync(`ps -p ${process.ppid} -o pid,ppid,command`, { encoding: 'utf8' });
-    console.log('   ' + psOutput.replace(/\n/g, '\n   '));
-
-    const ppidOutput = execSync(`ps -p ${process.ppid} -o command=`, { encoding: 'utf8' }).trim();
-    console.log(`\n   父进程命令: ${ppidOutput}`);
-
-    const guessAgentType = (cmd) => {
-      if (/claude/i.test(cmd)) return 'claude-desktop';
-      if (/cursor/i.test(cmd)) return 'cursor';
-      if (/continue/i.test(cmd)) return 'continue';
-      if (/zed/i.test(cmd)) return 'zed';
-      if (/workbuddy/i.test(cmd)) return 'workbuddy';
-      if (/openclaw/i.test(cmd)) return 'openclaw';
-      return 'unknown';
-    };
-
-    console.log(`   猜测的 Agent 类型: ${guessAgentType(ppidOutput)}`);
-
-  } catch (e) {
-    console.log(`   获取父进程信息失败: ${e.message}`);
-  }
-} else if (process.platform === 'win32') {
-  try {
-    const wmicOutput = execSync(`wmic process where processid=${process.ppid} get processid,parentprocessid,commandline`, { encoding: 'utf8' });
-    console.log('   ' + wmicOutput.replace(/\n/g, '\n   '));
-  } catch (e) {
-    console.log(`   获取父进程信息失败: ${e.message}`);
-  }
-}
-
-console.log('\n' + '='.repeat(60));