柴米记账 MCP Server

通过 OpenClaw、WorkBuddy 等 AI 工具直接记账，支持 MCP 协议的 Claude、Cursor 等。

系统要求

• Node.js >= 18.0.0
• macOS / Windows / Linux
• 微信（已安装"柴米记账"小程序）

快速安装

# 1. 安装 MCPorter（WorkBuddy/OpenClaw 等 OpenClaw 架构的 Agent 必需）
npm install -g mcporter

# 2. 安装柴米记账 MCP
npm install -g chaimi-keep-mcp

# 3. 启动（自动配置 mcporter）
chaimi-keep-mcp

首次使用

1. 触发授权

在 WorkBuddy/OpenClaw 中输入：

帮我记一笔午餐35元

2. 获取验证码

MCP Server 会显示验证码，请在"柴米记账"小程序中完成授权。

3. 小程序授权

打开"柴米记账"小程序 → 点击"我的" → "Agent 授权" → 输入验证码

4. 完成

授权成功后，AI 会自动完成记账。

支持的功能

| 工具 | 用途 | 示例 | |------|------|------| | save_expense | 单商品支出 | "午餐 35 元" | | save_receipt | 小票/多商品 | 拍照上传小票 | | save_income | 收入记录 | "工资到账 8000 元" | | get_expenses | 查询记录 | "查看本月消费" | | get_statistics | 消费统计 | "本月花了多少" |

常见问题

Q: 提示 "command not found" A: npm 全局安装后需要重启终端。

Q: 验证码无效 A: 验证码 30 分钟内有效，过期需要重新获取。

Q: 需要每次都授权吗 A: 不需要。Token 会自动刷新，除非超过 30 天未使用。

Q: 如何更新到最新版本 A: npm update -g chaimi-keep-mcp

技术支持

• 微信：solinxia
• 邮箱：[email protected]

Changelog

v4.0.0-beta.0 (2026-05-17) 🧪 MCP2.0

• 重大重构 后端AI解析，封闭Prompt，Prompt 不暴露给 Agent
• 新增 parse_text 一键记账（后端AI解析+自动保存）
• 移除 get_text_parse_prompt/get_parse_prompt Prompt 暴露工具
• 优化 记账流程简化为2步（获取Skill → parse_text）

v3.4.0 (2026-05-01) 🎉 正式版

• 正式版 多端记账分类统一
• 优化 回复模板优化

v3.1.44 (2026-04-21) 🎉 正式版

• 正式版 统一使用 Node.js 版本
• 安全 Token 加密存储（AES-256-CBC）

v2.0.0 (2026-04-03)

• 新增 OAuth 2.0 Device Flow 认证
• 新增 npm 全局安装支持

完整更新日志请查看 CHANGELOG.md