ClawHub

账本

MCP Tools

个人记账与资产管理 MCP 服务（陶朱账本）。通过 moneydata.cn MCP 接口管理收入、支出、资产买入/卖出、负债、交易记录、财富看板等。触发场景：用户提到记账、记收入、记支出、买资产、卖资产、查资产、查负债、查交易、查收支、财富看板、账本等个人财务操作。

Install

openclaw skills install zhangben

陶朱账本 (zhangben) MCP 技能

通过 https://moneydata.cn/mcp 的 MCP 接口管理个人财务。

§1 连接与认证

  • 身份标识ID (32位): 根据 MAC 地址 MD5 生成，⚠️ 更换会导致历史数据丢失！ 必须保存
  • Token 获取: POST https://moneydata.cn/api/user/token，body: {"code": "<code>"}
    • code 构造: 身份标识ID + 10位时间戳 + f5138595b7b93cd08b8c03bbaa825ddb
    • Token 过期后用同一身份标识ID + 新时间戳即可换新 token
  • 配置保存: 生成的身份标识ID和Token必须在配置文件中保存，方便调用MCP服务使用

§2 参数陷阱（必读！）

工具❌ 易错写法✅ 正确写法
buy_assetcode: "600519"price_code: "600519"
buy_assetprice: 1268cost_unit_price: 1268
buy_asset不传币种pay_currency: "CNY" (必填!)
sell_asset不传币种deposit_currency: "CNY" (必填!)
income/expense不传币种currency: "CNY" (必填!)
borrow/repay不传币种from_currency/to_currency: "CNY" (必填!)
get_income_expense_categorydirection: "income"direction: 1 (int)
各工具数字参数"101" (string)101 (number)

§3 操作速查

完整参数 schema 见 references/mcp-api.md，平台ID见 references/platform-ids.md，分类代码见 references/category-codes.md

记录收入

income(sub_category=2, amount=1000, platform_id=101, currency="CNY")
  • 工具名是 income，不是 record_income
  • record_date: 可选 YYYY-MM-DD

记录支出

expense(sub_category=44, platform_id=101, amount=2000, currency="CNY", pay_mode="balance", remark="买手机")
  • pay_mode 枚举: balance(余额) | credit(信用卡)，其他值报 [30018]
  • 信用消费不扣活期余额，记为信用卡欠款，通过 repay 还款

买入资产

buy_asset(sub_type=1, price_code="600519", quantity=2, cost_unit_price=1268,
          platform_id=1, from_platform_id=101, pay_currency="CNY")
  • platform_id: 存放平台(券商)，from_platform_id: 扣款平台(银行)，不传则同 platform_id
  • price_code: A股 600519/SH600519 均可，基金 F000051，黄金 UDFGOLD001

卖出资产

sell_asset(sub_type=1, price_code="SH600519", platform_id=1, quantity=1,
           sell_unit_price=1300, deposit_currency="CNY", to_platform_id=101)
  • price_code 最佳实践: 用 get_asset_list 返回的格式(A股 SH600519，港股 HK00700)
  • 返回: remaining_quantity(剩余持有)、realized_profit(盈亏)、deposit_asset_id

借款/还款

borrow(from_sub_type=46, from_platform_id=101, from_currency="CNY",
       to_sub_type=21, to_platform_id=105, to_currency="CNY", quantity=100000)
repay(from_sub_type=21, from_platform_id=101, from_currency="CNY",
      to_sub_type=49, to_platform_id=101, to_currency="CNY", quantity=100)
  • borrow: from_sub_type=46(房贷)/47(车贷)/48(消费贷)/49(信用贷)，to_sub_type=仅21(活期)
  • repay: from_sub_type=仅21(活期)，to_sub_type=46/47/48/49

查询工具

工具用途关键提醒
get_asset_list资产列表证券 category=0(非10)；看 base(CNY) 非 original；include_cleared(bool)含已清仓
get_liability_list负债列表看 remaining_amount，⚠️ base.total_value 可能=0
get_transaction_list交易记录biz_type: buy_asset/sell_asset/income/expense/repay/borrow/transfer
get_dashboard_summary财富看板总资产/总负债/净资产/月年变化
get_income_summary收入汇总传 category 按二级汇总，不传按一级
get_expense_summary支出汇总同上
get_platform_list平台列表可按 sub_type 过滤
get_income_expense_category收支分类direction=1(收入)/2(支出)，int 非 string

§4 重要提醒

  • 跨币种买入: 买港股必须传 pay_currency="CNY"，系统自动按汇率折算扣款
  • 负债查询: 看 remaining_amount(待还金额)
  • 数量单位: 股票=股，基金=份，黄金=克
  • 错误码速查: 30014(余额不足) 31002(必填缺失) — 完整列表见 references/errorcode.md
More in MCP Tools