AI导哈

预算数据查询服务器

一个用于Actual Budget的Model Context Protocol (MCP)服务器，允许通过Claude或其他MCP兼容的AI助手查询预算数据。

  • by 3stacks
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 3stacks/actual-mcp

使用说明

实际预算MCP服务器

一种模型上下文协议（MCP）服务器 实际预算 它允许您通过Claude或其他兼容MCP的AI助手查询预算数据。

特性

  • 预算概述 -通过支出与预算获取当月预算
  • 事务管理 -查询交易、添加新交易、对现有交易进行分类
  • 消费历史 -分析一段时间内的支出模式
  • 可自由支配的开支 -根据上限跟踪可自由支配的支出
  • 货币时代 -YNAB风格的指标，显示资金在花费前存放了多长时间
  • 房屋净值 -追踪房屋净值明细（存款、已付本金、升值）

设置

1.安装依赖项

npm install

2.配置环境

复制 .env.example 到 .env 并填写您的实际预算服务器详细信息：

cp .env.example .env

所需设置：

  • ACTUAL_SERVER_URL -您的实际预算服务器URL
  • ACTUAL_PASSWORD -您的服务器密码
  • ACTUAL_SYNC_ID -您的预算同步ID

查找您的同步ID:

  1. 打开实际预算
  2. 转到“设置”→ 显示高级设置
  3. 查找“同步ID”-它是一个UUID，类似于 6e1dbd4a-88ae-4edf-bd8f-ab1c031057b2

可选（用于房屋净值跟踪）：

  • HOME_PURCHASE_PRICE -原始购买价格
  • HOME_INITIAL_LOAN -初始贷款金额
  • HOME_VALUE_ACCOUNT -您的房屋价值资产账户名称
  • HOME_LOAN_ACCOUNT -您的抵押贷款负债账户名称

3.建造

npm run build

4.添加到克劳德代码

添加到您的 ~/.claude.json:

{
  "mcpServers": {
    "actual-budget": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/actual-budget-mcp/build/index.js"]
    }
  }
}

重新启动Claude Code以加载MCP。

可用工具

预算查询

  • get_budget -本月预算概览
  • get_budget_month -特定月份的预算
  • get_categories -列出所有类别
  • get_accounts -列出有余额的账户

交易

  • get_transactions -按账户和日期范围查询交易
  • add_transaction -添加新交易
  • categorize_transaction -更新交易的类别

分析

  • get_spending_history -随着时间的推移，按类别划分的支出
  • get_discretionary_spending -追踪自由裁量上限
  • get_age_of_money -YNAB风格的货币年龄指标
  • get_home_equity -房屋净值明细

示例用法

配置后，您可以向Claude询问以下问题：

  • “我这个月的预算是多少？”
  • “在我的信用卡上加一笔50美元的费用，在Woolworths购买杂货”
  • “我的钱几岁了？”
  • “显示我的房屋净值明细”
  • “在过去的6个月里，我在外出就餐上花了多少钱？”

需求

  • Node.js 18+
  • 运行实际预算服务器
  • Claude Code或其他MCP兼容客户端

许可证

ISC

相关 MCP