Budget Tracker by Smart Money

en • ru

Smart Money MCP 预算跟踪器

用于个人理财的模型上下文协议服务——用日常语言记录支出、跟踪账户、存款、预算和消费，并由 OAuth 保护。

Smart Money MCP 预算跟踪器将你的资金账本接入 AI 助手。将 Claude、ChatGPT、Cursor、VS Code 或命令行客户端连接到 Smart Money 预算跟踪器，然后说 “昨天用 Kaspi 支付了 4500 的出租车费，记一下”，或询问 “我这个月在食物上花了多少钱？”——助手会将记录写入应用读取的同一本账本。

• 服务 URL： https://smart-money.ink/mcp
• 传输方式： Streamable HTTP
• 身份验证： 使用 PKCE 的 OAuth 2.1
• 介绍与设置： smart-money.ink/claude

安装

Smart Money MCP 预算跟踪器是一个远程、由 OAuth 保护的服务。无需在本地安装任何内容。将以下配置添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "smart-money": {
      "type": "http",
      "url": "https://smart-money.ink/mcp"
    }
  }
}

一键安装：

命令行客户端（Claude Code、Gemini CLI、Codex CLI）和手动配置片段：请参阅支持的客户端。

快速开始

1. 在 smart-money.ink 创建 Smart Money 预算跟踪器账户并开始免费试用（请参阅套餐与访问权限）。
2. 打开 smart-money.ink/claude，按照适用于你所用客户端的设置步骤操作。
3. 使用一键安装、命令行命令或上方的手动 JSON 配置片段。
4. 当客户端打开授权同意页面时，通过 OAuth 完成授权。
5. 用日常语言和助手讨论理财。

你可以在聊天中完成的操作

• 💬 用日常语言记账 — taxi 4500 yesterday kaspi #trip 会被解析为金额、日期、账户、货币、标签和类别。12k 或 1.2m 这样的金额、yesterday 或 3 days ago 这样的日期，以及任意文字体系的账户名称，都能正确识别。
• 📊 消费情况查询 — 查询任意时段的收入、支出、储蓄率、类别明细和消费金额最高的商家。
• 🏦 账户与余额 — 支持银行卡、现金、银行账户、存款、信用卡（计为负债）、投资和电子钱包。支持多种货币，按指定日期的汇率换算，并以基础货币显示总额。
• 💰 带利息的存款 — 可设置以基点表示的利率、计息频率、复利方式或将利息支付到其他账户。利息按实际余额逐日计算；每次计息都会携带幂等键，因此不会重复记账。
• 🎯 预算 — 可设置周度、月度或年度限额，并查看已支出金额、剩余额度和期末预测。
• 📥 银行通知 — 粘贴推送通知文本即可将其转为交易；重新导入同一条通知不会产生重复记录。
• 🏷️ 类别与标签 — 类别采用扁平结构，可在一步中选定；标签与类别相互独立。遇到未知的 #tag 时会即时创建；如果该标签已删除，则会恢复它而非创建重复项。

工具概览

27 个工具。读取和写入是分开的工具——没有 confirm 或 dryRun 标志——且每个工具都带有 title 以及 readOnlyHint / destructiveHint 注解，以便客户端知道哪些调用需要确认提示。

类别	工具
👀 预览 (只读)	preview_entry、preview_notifications、preview_interest — 在写入任何内容前显示解析结果
💸 交易	quick_add、add_transaction、list_transactions、update_transaction、delete_transaction、import_notifications
📊 报告	summary — 查看某个时段的收入、支出、储蓄率、类别和热门商户
🏦 账户	list_accounts、create_account、update_account、delete_account、accrue_interest
🗂️ 类别	list_categories、create_category、update_category、delete_category
🏷️ 标签	list_tags、create_tag、update_tag、delete_tag
🎯 预算	list_budgets、create_budget、update_budget、delete_budget

删除采用软删除：交易会添加 deletedAt，并在所有设备上从余额和报告中移除，但其导入键会保留——因此，重新导入同一条银行通知不会恢复该交易。仍被交易引用的账户或类别无法删除；连接器会提供归档选项，以确保历史记录不会指向不存在的对象。

如需查看准确且最新的工具列表，请对 https://smart-money.ink/mcp 调用 tools/list。

套餐与访问权限

Smart Money 的 Budget Tracker 是一项付费服务，提供免费试用。连接器会读取和写入你的真实账本，因此需要有效订阅或试用；不提供匿名使用套餐。

	免费试用	订阅
价格	7 天免费，需提供银行卡	$7.99 / 月
Web 应用、同步和所有连接器工具	✅	✅

试用期间不会扣费，试用期间取消也不会产生费用。可随时在 设置 → 订阅 中取消。订阅到期后，应用会锁定，但记录不会删除：它们仍保存在浏览器中，且仍可导出。当前条款：smart-money.ink/terms。

如果未订阅或试用已失效就调用工具，工具结果会说明这一点，并引导你前往应用设置。

支持的客户端

• Claude（网页和桌面）——设置 → 连接器 → 添加自定义连接器
• ChatGPT ——设置 → 连接器 → 使用 OAuth 的自定义 MCP 连接器
• Cursor ——通过深层链接一键安装，或使用 ~/.cursor/mcp.json
• VS Code ——通过深层链接一键安装，或使用 .vscode/mcp.json
• Claude Code (CLI) ——claude mcp add --transport http smart-money https://smart-money.ink/mcp
• Gemini CLI ——gemini mcp add --transport http smart-money https://smart-money.ink/mcp
• Codex CLI ——codex mcp add smart-money --url https://smart-money.ink/mcp
• 通用 HTTP MCP 客户端 ——将其指向该 URL，并让它完成 OAuth 发现

各客户端的完整说明：docs/setup.md。

Cursor 插件

此仓库也是一个 Cursor 插件。它提供一个 MCP 服务（smart-money），不包含规则、技能、Agent 或钩子。

.cursor-plugin/plugin.json   ← plugin manifest
mcp.json                     ← the MCP server it contributes
assets/logo.svg              ← plugin logo

无需进行任何配置。无需 API 密钥或环境变量：服务会公布 OAuth 2.1 元数据，客户端会动态注册自身，并在首次使用时打开授权页面。

示例提示词

边记边记账

“昨天打车 4500 kaspi #trip”

→ 解析并保存一笔交易：金额、日期、账户、标签。预览工具可以先展示解析结果。

询问钱花到哪里了

“我这个月在吃饭上花了多少钱？和预算相比如何？”

→ 按类别汇总，并显示预算的已花费金额、剩余金额和月底预测。

存款

“记入我存款应得的利息。”

→ 按实际余额每日计息，且支持幂等：运行两次不会额外记入利息。

银行通知

（粘贴一批银行推送通知）“把这些转换成交易。”

→ 将通知解析为交易，并跳过已导入的交易。

更多内容：docs/examples.md。

授权与数据

认证采用 OAuth 2.1 和 PKCE。你的助手会获得一个与 Budget Tracker by Smart Money 账户关联的令牌，连接器会以你的身份读取和写入数据——行级安全和订阅检查的规则与 Web 应用完全相同。发现流程遵循 RFC 9728：未经认证的 /mcp 调用会返回 401，并指向 https://smart-money.ink/.well-known/oauth-protected-resource/mcp，授权服务器可从该地址找到。

你可以随时在 Budget Tracker by Smart Money 应用中撤销令牌。OAuth 流程详情：docs/oauth.md。数据处理方式：smart-money.ink/privacy。

故障排除

常见的连接、OAuth 和工具调用错误：docs/troubleshooting.md。

本服务的收录位置

注册表和目录中的收录信息，以及发布方式：docs/registries.md。

项目链接

• 产品：smart-money.ink
• 设置页面：smart-money.ink/claude
• MCP 服务：https://smart-money.ink/mcp
• 问题反馈：github.com/ultraza4/smart-money-mcp/issues

许可证

MIT — 参见 LICENSE。

---

由 @ultraza4 构建。Budget Tracker by Smart Money 是一项托管式个人财务服务；此仓库包含其公开 MCP 服务的文档和清单。服务端源代码不开源。