chaimi-bookkeeping-mcp 2.1.0

package/.env

@@ -0,0 +1,6 @@
+# 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

@@ -0,0 +1,5 @@
+# /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.example

@@ -0,0 +1,26 @@
+# 柴米记账 MCP Server 环境变量配置
+# OAuth 2.0 Device Flow 认证（行业标准方案）
+
+# ========================================
+# 必需配置
+# ========================================
+
+# OAuth 云函数地址
+# 首次启动会自动引导完成授权，Token 存储在 ~/.mcporter/oauth-token.json
+MCP_OAUTH_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpOAuth
+
+# mcpHub 云函数地址
+MCP_HUB_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpHub-mcp
+
+# mcpPrompt 云函数地址
+MCP_PROMPT_URL=https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpPrompt
+
+# ========================================
+# 可选配置
+# ========================================
+
+# AI API Key（用于本地解析）
+AI_API_KEY=
+
+# AI 提供商（openai/anthropic/deepseek）
+AI_PROVIDER=deepseek

package/.env.test

@@ -0,0 +1,4 @@
+# 测试环境配置
+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

@@ -0,0 +1,6 @@
+# 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/README.md

@@ -0,0 +1,120 @@
+# 柴米记账 MCP Server
+
+通过 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账。
+
+## 系统要求
+
+- Node.js >= 18.0.0
+- macOS / Windows / Linux
+- 微信（已安装"柴米记账"小程序）
+
+## 快速安装
+
+### 方式一：npm 全局安装（推荐）
+
+```bash
+# 安装
+npm install -g chaimi-bookkeeping-mcp
+
+# 启动（自动配置 mcporter）
+chaimi-bookkeeping-mcp
+```
+
+### 方式二：手动下载安装
+
+1. 从 GitHub Releases 下载安装包
+2. 解压后进入目录
+3. 安装依赖：`npm install`
+4. 手动配置 `~/.mcporter/mcporter.json`
+
+## 首次使用
+
+### 1. 触发授权
+
+在 WorkBuddy/OpenClaw/Claude 中输入：
+
+```
+帮我记一笔午餐35元
+```
+
+### 2. 获取验证码
+
+MCP Server 会显示：
+
+```
+╔════════════════════════════════════════════════════════╗
+║  柴米记账 MCP Server - 首次使用需要授权                ║
+╠════════════════════════════════════════════════════════╣
+║                                                        ║
+║  请在微信中打开以下链接完成授权：                      ║
+║                                                        ║
+║  https://mcp.chaihuo.com/auth?code=ABCD-EFGH          ║
+║                                                        ║
+║  或手动输入验证码：ABCD-EFGH                           ║
+║                                                        ║
+║  1. 打开"柴米记账"小程序                               ║
+║  2. 点击"我的" → "🤖 Agent 授权"                      ║
+║  3. 输入上述验证码                                     ║
+║                                                        ║
+╚════════════════════════════════════════════════════════╝
+```
+
+### 3. 小程序授权
+
+- **PC 端用户**：点击链接自动唤起微信授权
+- **手机端用户**：打开小程序 → 我的 → Agent 授权 → 输入验证码
+
+### 4. 完成
+
+授权成功后，AI 会自动完成记账。
+
+## 配置说明
+
+如果使用手动安装，需要配置 `~/.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"
+      }
+    }
+  }
+}
+```
+
+## 常见问题
+
+**Q: 提示 "command not found: chaimi-bookkeeping-mcp"**
+
+A: npm 全局安装后需要重启终端，或检查 npm 全局路径是否加入环境变量。
+
+**Q: 验证码无效**
+
+A: 验证码 30 分钟内有效，过期需要重新获取。
+
+**Q: 需要每次都授权吗**
+
+A: 不需要。Token 会自动刷新，除非超过 30 天未使用。
+
+**Q: 如何更新到最新版本**
+
+A: `npm update -g chaimi-bookkeeping-mcp`
+
+## 技术支持
+
+- 微信：xxxxx
+- 邮箱：support@chaihuo.com
+- GitHub Issues: https://github.com/yourusername/chaimi-bookkeeping-mcp/issues
+
+## 更新日志
+
+### v2.1.0 (2026-04-03)
+- 升级 OAuth 2.0 Device Flow 认证
+- 支持 npm 全局安装
+- 支持多种 AI 工具（Claude、Cursor、OpenClaw、WorkBuddy）
+- 自动 Token 刷新

package/SKILL.md

@@ -0,0 +1,134 @@
+# 柴米记账 Skill
+
+## 简介
+
+柴米记账是一款智能记账工具，支持通过自然语言快速记录消费。本 Skill 让 WorkBuddy 能够自动识别记账意图，调用 MCP 工具完成记账。
+
+## 安装
+
+本 Skill 文件随 MCP Server 一起提供，位于 `mcp-server-local/SKILL.md`。
+
+将本 Skill 复制到 WorkBuddy 的 skills 目录：
+
+```bash
+# 全局安装（推荐）
+mkdir -p ~/.workbuddy/skills/柴米记账/
+cp /path/to/caihuo_record_list/mcp-server-local/SKILL.md ~/.workbuddy/skills/柴米记账/
+
+# 或项目级安装
+mkdir -p ./.workbuddy/skills/柴米记账/
+cp /path/to/caihuo_record_list/mcp-server-local/SKILL.md ./.workbuddy/skills/柴米记账/
+```
+
+## 触发条件
+
+当用户输入包含以下关键词时，自动触发本 Skill：
+
+- 记账、花了、买了、消费、支出、付款
+- 吃饭、购物、交通、娱乐、医疗、教育
+- 元、块、钱、¥、$
+- 超市、餐厅、商场、医院、学校
+
+## 操作规范
+
+### 1. 单商品记账
+
+**用户示例：**
+- "中午吃了碗面，25元"
+- "买了杯咖啡35"
+- "打车花了50块"
+
+**调用工具：** `chaihuo.save_expense`
+
+**参数提取：**
+| 参数 | 提取规则 | 示例 |
+|------|---------|------|
+| name | 商品/服务名称 | "牛肉面"、"咖啡"、"打车" |
+| amount | 金额数字 | 25、35、50 |
+| category | 智能分类（见下表） | "餐饮"、"交通" |
+| store | 商家名称（如有） | "星巴克"、"滴滴" |
+
+**智能分类规则：**
+| 关键词 | 分类 |
+|--------|------|
+| 吃、饭、面、咖啡、奶茶、餐厅 | 餐饮 |
+| 打车、滴滴、地铁、公交、加油 | 交通 |
+| 超市、买菜、水果、零食 | 食品 |
+| 衣服、鞋、包、化妆品、购物 | 购物 |
+| 电影、游戏、KTV、娱乐 | 娱乐 |
+| 药、医院、看病、体检 | 医疗 |
+| 书、课程、学费、培训 | 教育 |
+| 其他 | 其他 |
+
+### 2. 小票记账
+
+**用户示例：**
+- "在沃尔玛买了牛奶30，面包15，鸡蛋20"
+- "晚餐：小炒肉45，米饭5，可乐8"
+
+**调用工具：** `chaihuo.save_receipt`
+
+**参数提取：**
+| 参数 | 提取规则 |
+|------|---------|
+| store | 商家名称（第一句提到） |
+| items | 商品列表，每个包含 name 和 amount |
+| totalAmount | 自动计算总和 |
+
+**商品解析示例：**
+用户："在沃尔玛买了牛奶30，面包15"
+→ items: [
+  { name: "牛奶", amount: 30 },
+  { name: "面包", amount: 15 }
+]
+→ totalAmount: 45
+
+## 回复格式
+
+**成功时，只输出：**
+```
+✅ [商品名] ¥[金额] 已录入柴米记账
+```
+
+**示例：**
+- ✅ 牛肉面 ¥25 已录入柴米记账
+- ✅ 咖啡 ¥35 已录入柴米记账
+- ✅ 小票（3件商品）¥58 已录入柴米记账
+
+**失败时，输出：**
+```
+❌ 记账失败：[错误原因]
+```
+
+## 注意事项
+
+1. **不要暴露技术细节**：不显示 MCP 工具名、参数、JSON 等
+2. **自动分类**：根据关键词智能判断分类，不确定时用"其他"
+3. **金额识别**：支持"元"、"块"、"¥"等格式
+4. **多商品**：一句话多个商品时，优先使用小票记账
+
+## 配置要求
+
+需要提前配置柴米记账 MCP Server：
+
+```json
+{
+  "mcpServers": {
+    "chaihuo": {
+      "command": "node",
+      "args": ["/path/to/caihuo_record_list/mcp-server-local/server.js"],
+      "env": {
+        "MCP_HUB_URL": "https://xxx.ap-shanghai.app.tcloudbase.com/mcpHub-mcp",
+        "MCP_TOKEN": "your-token",
+        "MCP_OPENID": "your-openid"
+      }
+    }
+  }
+}
+```
+
+Token 获取方式：微信小程序「柴米记账」→ 我的 → 桌面端记账 → 生成 Token
+
+## 版本
+
+- v1.0.0 - 支持单商品记账和小票记账

package/bin/cli.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+/**
+ * 柴米记账 MCP Server CLI 入口
+ */
+
+const path = require('path');
+const { spawn } = require('child_process');
+
+// 获取 server.js 的绝对路径
+const serverPath = path.join(__dirname, '..', 'server.js');
+
+// 启动 server.js
+const child = spawn('node', [serverPath], {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('exit', (code) => {
+  process.exit(code);
+});

package/config.yaml

@@ -0,0 +1,18 @@
+# 柴米记账 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/install.sh

@@ -0,0 +1,268 @@
+#!/bin/bash
+
+# 柴米记账 MCP Server 一键安装脚本
+# 支持 macOS 和 Linux
+# 用法: curl -fsSL https://chaihuo.io/install.sh | bash
+
+set -e
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# 配置
+INSTALL_DIR="$HOME/.chaihuo-mcp"
+WORKBUDDY_DIR="$HOME/WorkBuddy"
+PYTHON_VERSION="3.10"
+SCF_URL="https://1412172089-4wbwsop8pe.ap-shanghai.tencentscf.com"
+
+echo -e "${GREEN}=== 柴米记账 MCP Server 安装脚本 ===${NC}"
+echo ""
+
+# 检测操作系统
+OS="$(uname -s)"
+case "${OS}" in
+    Linux*)     PLATFORM=Linux;;
+    Darwin*)    PLATFORM=Mac;;
+    *)          PLATFORM="UNKNOWN:${OS}"
+esac
+
+echo -e "${YELLOW}检测到操作系统: ${PLATFORM}${NC}"
+
+# 检查并安装 Python 3.10+
+check_python() {
+    echo -e "${YELLOW}检查 Python 版本...${NC}"
+    
+    if command -v python3.10 &> /dev/null; then
+        PYTHON_CMD="python3.10"
+    elif command -v python3.11 &> /dev/null; then
+        PYTHON_CMD="python3.11"
+    elif command -v python3.12 &> /dev/null; then
+        PYTHON_CMD="python3.12"
+    elif command -v python3 &> /dev/null; then
+        PY_VERSION=$(python3 --version 2>&1 | awk '{print $2}' | cut -d. -f1,2)
+        if (( $(echo "$PY_VERSION >= 3.10" | bc -l) )); then
+            PYTHON_CMD="python3"
+        else
+            PYTHON_CMD=""
+        fi
+    else
+        PYTHON_CMD=""
+    fi
+    
+    if [ -z "$PYTHON_CMD" ]; then
+        echo -e "${RED}未检测到 Python 3.10+${NC}"
+        install_python
+    else
+        echo -e "${GREEN}找到 Python: $PYTHON_CMD${NC}"
+    fi
+}
+
+# 安装 Python 3.10
+install_python() {
+    echo -e "${YELLOW}正在安装 Python 3.10...${NC}"
+    
+    if [ "$PLATFORM" == "Mac" ]; then
+        # macOS
+        if command -v brew &> /dev/null; then
+            echo "使用 Homebrew 安装 Python 3.10..."
+            brew install python@3.10
+            PYTHON_CMD="/opt/homebrew/bin/python3.10"
+        else
+            echo -e "${RED}请先安装 Homebrew: https://brew.sh${NC}"
+            exit 1
+        fi
+    elif [ "$PLATFORM" == "Linux" ]; then
+        # Linux
+        if command -v apt-get &> /dev/null; then
+            echo "使用 apt 安装 Python 3.10..."
+            sudo apt-get update
+            sudo apt-get install -y python3.10 python3.10-venv python3.10-pip
+            PYTHON_CMD="python3.10"
+        elif command -v yum &> /dev/null; then
+            echo "使用 yum 安装 Python 3.10..."
+            sudo yum install -y python310
+            PYTHON_CMD="python3.10"
+        else
+            echo -e "${RED}不支持的 Linux 发行版，请手动安装 Python 3.10+${NC}"
+            exit 1
+        fi
+    else
+        echo -e "${RED}不支持的操作系统: ${PLATFORM}${NC}"
+        exit 1
+    fi
+}
+
+# 创建安装目录
+setup_install_dir() {
+    echo -e "${YELLOW}创建安装目录...${NC}"
+    
+    if [ -d "$INSTALL_DIR" ]; then
+        echo -e "${YELLOW}目录已存在，清理旧文件...${NC}"
+        rm -rf "$INSTALL_DIR"
+    fi
+    
+    mkdir -p "$INSTALL_DIR"
+    echo -e "${GREEN}安装目录: $INSTALL_DIR${NC}"
+}
+
+# 创建虚拟环境
+create_venv() {
+    echo -e "${YELLOW}创建 Python 虚拟环境...${NC}"
+    
+    $PYTHON_CMD -m venv "$INSTALL_DIR/venv"
+    source "$INSTALL_DIR/venv/bin/activate"
+    
+    echo -e "${GREEN}虚拟环境创建成功${NC}"
+}
+
+# 安装依赖
+install_dependencies() {
+    echo -e "${YELLOW}安装依赖...${NC}"
+    
+    pip install --upgrade pip
+    pip install fastmcp>=0.4.0 requests
+    
+    echo -e "${GREEN}依赖安装完成${NC}"
+}
+
+# 下载 MCP Server 文件
+download_server() {
+    echo -e "${YELLOW}下载 MCP Server...${NC}"
+    
+    # 复制本地文件（如果是本地安装）
+    if [ -f "server.py" ]; then
+        cp server.py "$INSTALL_DIR/"
+        echo -e "${GREEN}使用本地 server.py${NC}"
+    else
+        # 从远程下载
+        echo "从远程下载..."
+        curl -fsSL -o "$INSTALL_DIR/server.py" "https://raw.githubusercontent.com/chaihuo/mcp-server/main/server.py"
+        echo -e "${GREEN}下载完成${NC}"
+    fi
+}
+
+# 配置 WorkBuddy
+configure_workbuddy() {
+    echo -e "${YELLOW}配置 WorkBuddy...${NC}"
+    
+    if [ ! -d "$WORKBUDDY_DIR" ]; then
+        echo -e "${RED}未找到 WorkBuddy 目录: $WORKBUDDY_DIR${NC}"
+        echo "请确认 WorkBuddy 已安装，或手动配置 MCP"
+        return 1
+    fi
+    
+    # 创建 MCP 配置
+    mkdir -p "$WORKBUDDY_DIR/mcp"
+    
+    # 复制 server.py 到 WorkBuddy 目录
+    cp "$INSTALL_DIR/server.py" "$WORKBUDDY_DIR/mcp/chaihuo-server.py"
+    
+    # 创建配置文件
+    cat > "$WORKBUDDY_DIR/mcp_config.json" << EOF
+{
+  "mcpServers": {
+    "chaihuo": {
+      "command": "$INSTALL_DIR/venv/bin/python",
+      "args": ["$WORKBUDDY_DIR/mcp/chaihuo-server.py"],
+      "env": {
+        "SCF_URL": "$SCF_URL"
+      }
+    }
+  }
+}
+EOF
+    
+    echo -e "${GREEN}WorkBuddy 配置完成${NC}"
+    echo -e "${YELLOW}配置文件: $WORKBUDDY_DIR/mcp_config.json${NC}"
+}
+
+# 生成 JWT Secret
+generate_jwt_secret() {
+    echo -e "${YELLOW}生成 JWT Secret...${NC}"
+    
+    JWT_SECRET=$(openssl rand -base64 32)
+    
+    # 更新配置文件
+    cat > "$WORKBUDDY_DIR/mcp_config.json" << EOF
+{
+  "mcpServers": {
+    "chaihuo": {
+      "command": "$INSTALL_DIR/venv/bin/python",
+      "args": ["$WORKBUDDY_DIR/mcp/chaihuo-server.py"],
+      "env": {
+        "SCF_URL": "$SCF_URL",
+        "JWT_SECRET": "$JWT_SECRET"
+      }
+    }
+  }
+}
+EOF
+    
+    echo -e "${GREEN}JWT Secret 生成成功${NC}"
+    echo -e "${YELLOW}请保存以下密钥（用于生成用户 Token）:${NC}"
+    echo -e "${GREEN}$JWT_SECRET${NC}"
+}
+
+# 测试安装
+test_installation() {
+    echo -e "${YELLOW}测试安装...${NC}"
+    
+    source "$INSTALL_DIR/venv/bin/activate"
+    
+    if python -c "import fastmcp" 2>/dev/null; then
+        echo -e "${GREEN}✓ fastmcp 安装成功${NC}"
+    else
+        echo -e "${RED}✗ fastmcp 安装失败${NC}"
+        return 1
+    fi
+    
+    if [ -f "$INSTALL_DIR/server.py" ]; then
+        echo -e "${GREEN}✓ server.py 存在${NC}"
+    else
+        echo -e "${RED}✗ server.py 不存在${NC}"
+        return 1
+    fi
+    
+    echo -e "${GREEN}安装测试通过！${NC}"
+}
+
+# 打印完成信息
+print_finish() {
+    echo ""
+    echo -e "${GREEN}=== 安装完成！===${NC}"
+    echo ""
+    echo -e "${YELLOW}下一步操作:${NC}"
+    echo "1. 重启 WorkBuddy"
+    echo "2. 在 WorkBuddy 中测试记账功能"
+    echo ""
+    echo -e "${YELLOW}配置信息:${NC}"
+    echo "- 安装目录: $INSTALL_DIR"
+    echo "- 配置文件: $WORKBUDDY_DIR/mcp_config.json"
+    echo "- SCF 地址: $SCF_URL"
+    echo ""
+    echo -e "${YELLOW}如需卸载，运行:${NC}"
+    echo "rm -rf $INSTALL_DIR"
+    echo ""
+}
+
+# 主流程
+main() {
+    echo -e "${GREEN}开始安装柴米记账 MCP Server...${NC}"
+    echo ""
+    
+    check_python
+    setup_install_dir
+    create_venv
+    install_dependencies
+    download_server
+    configure_workbuddy
+    generate_jwt_secret
+    test_installation
+    print_finish
+}
+
+# 运行主流程
+main