金融与投行

Quicken Mac 只读查询技能

让 Claude 直接以只读方式查询 Quicken for Mac 的 SQLite 数据库,安全回答账户、交易、支出与投资问题。

64/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 45
最近更新
1 个月前
License
MIT
quickensqlitepersonal-financeread-only-queries
+4mcp-servercsv-exportcore-datasql

这个 Skill 能做什么,适合哪些场景?

这是一个面向 Quicken for Mac 用户的 Claude 技能与 MCP 服务器组合。Quicken 将数据存在加密的 Core Data SQLite 数据库里,只有应用运行时才可读;本技能教 Claude 用只读 SQL 直接查询该数据库,无需导出或修改数据。仓库同时提供八个预置 MCP 工具和 qmac 命令行界面,并附一个可导出全部财务历史为 CSV 的 Python 脚本。仅支持 macOS,且使用时 Quicken 必须处于打开状态。

  • 以只读模式打开 Quicken .quicken 数据包中的 data 文件(sqlite3 -readonly 或 mode=ro),并用内置探测脚本验证数据库已解锁且含预期表结构
  • 直接执行 SQL 回答账户余额、净资产、按类别支出、月度趋势、收款方、转账、预算、标签和投资持仓等问题
  • 处理 Core Data 时间戳换算(+978307200)、拆分金额求和、半开日期区间等关键细节
  • MCP 服务器提供 list_accounts、query_transactions、spending_by_category 等 8 个工具
  • 另有 export_sovereign_csv.py 将全部数据导出为规范化 CSV 与 schema
  • 全程不写入、不迁移、不修改数据库
适合
  • Quicken for Mac 重度用户想让 Claude 直接回答'上个月 groceries 花了多少钱',而不想手动导出报表
  • 在 Claude Code 里做个人财务月度复盘:按类别、按月统计支出与现金流
  • 非 Claude 的 MCP 客户端(Cursor、Cline)用户,希望通过类型化工具查询 Quicken 数据
  • 想把自己的完整财务历史迁出 Quicken,导入 DuckDB、Pandas 或 PostgreSQL 自建分析平台
  • 投资者想查看持仓构成、成本 basis 和 Quicken 存储的报价(仅作持仓分析,不用交易求和推算余额)
不适合
  • Quicken Windows 用户或非 macOS 环境(技能仅支持 Quicken for Mac,且使用时应用须打开)
  • 想修改、迁移或写入 Quicken 数据库的场景(技能严格只读)
  • 寻求一般性个人理财建议或处理非 Quicken 数据的用户(SKILL.md 明确排除)

如何安装这个 Skill?

使用前请注意
  • 本评审为纯静态源码审阅,未执行任何查询或脚本,技能 SQL 配方在真实 Quicken 文件上的正确性未经独立验证。
  • 技能自身的关键 SQL 路径缺少提交的测试证据;仓库中的 CI/测试主要覆盖 MCP 服务器而非该 SKILL.md 配方。
  • schema 标识符(Z_ENT、join 表)在不同 Quicken 版本/文件间可能变化,使用前必须按文档逐文件勘察,不应假设示例值适用。
  • 仅支持 macOS 与 Quicken for Mac,且要求应用处于打开解锁状态;文档为英文,无中文支持。
  • 发布者身份未经 FollowSkills 企业注册表验证;使用前请自行核对仓库与 npm provenance。
  • 技能处理高敏感财务数据:建议在隔离环境试用,避免账号号码等敏感值进入对话输出。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • macOS
  • Quicken for Mac (open/unlocked)
  • Python 3 (probe & CSV exporter)
  • sqlite3

推荐方式(Claude Code,技能+MCP 一起装):

claude plugin install quicken-mac-mcp

仅 MCP(Claude Desktop 或其他 MCP 客户端):

claude mcp add quicken -- npx -y quicken-mac-mcp

或在 claude_desktop_config 中加入对应 mcpServers 配置(可下载 release 的 .mcpb 拖入 Claude Desktop)。多个数据文件或非默认位置时设置 QUICKEN_DB_PATH 环境变量。前提:macOS + Quicken for Mac,使用时应用须打开。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 我上个月在食品杂货上花了多少钱?
  • 列出我所有账户的余额和净资产
  • 按类别统计今年每月的支出趋势
  • 我的投资持仓构成和成本基础是什么?

确保 Quicken for Mac 已打开并登录(否则数据库加密不可读),然后直接向 Claude 提问,如'列出我的账户'、'2024 年我按类别的支出'、'找出 Costco 超过 $100 的交易'。技能会先用探测脚本定位并验证数据库,再执行只读 SQL 并附带日期范围、账户范围等假设说明。终端用户也可用 qmac CLI(如 qmac spending-by-category --start-date 2025-01-01 --end-date 2025-03-31)或运行 python3 scripts/export_sovereign_csv.py 导出全部数据。完整使用步骤见仓库 README 与 SKILL.md。

这个 Skill 有哪些优点和局限?

优点
  • 严格只读:不写入、不迁移、不修改数据库,不拼接 SQL、参数化用户输入
  • 附带详细的 schema 知识和参考文档,处理 Core Data 时间戳、拆分金额、转账过滤等易错点
  • 三种使用方式:Claude 技能、MCP 服务器(8 个工具)、独立的 qmac CLI
  • 附带零依赖 Python 导出器,可把全部财务历史打包为 CSV + schema. 用于自建分析
  • MIT 许可,已上架 npm 和 MCP Registry
局限
  • 仅支持 macOS 和 Quicken for Mac(不支持 Quicken Windows),且使用时 Quicken 必须打开,否则数据库加密不可读
  • 是社区独立项目,与 Intuit/Quicken 官方无关,Quicken 版本升级可能改变 schema
  • 存量的投资报价可能过期,技能自身要求对余额标注来源与时效警告
  • README 未提供测试覆盖率或跨版本兼容性验证的证据

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Quicken Mac 只读查询技能 本页 64 · 推荐 ★ 45 1 个月前 MIT
TradingView MCP 智能交易助手 50 · 谨慎使用 ★ 5.1k 11 天前 MIT
OpenNews 金融新闻聚合 47 · 谨慎使用 ★ 2.4k 2 个月前 MIT
MetaTrader 5 交易终端助手 47 · 谨慎使用 ★ 827 7 个月前 MIT
EdgarTools — SEC EDGAR 文件分析技能 67 · 推荐 ★ 2.8k 11 天前 MIT

源材料未列出直接竞品。若你在 Claude Code 等支持技能的客户端,README 明确建议优先用技能(直接写 SQL、无需常驻 MCP 进程);只有在无法加载技能的 MCP 客户端中才用 MCP 服务器包装。两者共享同一套 schema 知识。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
64/ 100 五分制 3.2 / 5
1信任安全22 / 25 · 4.4/5

证据显示严格的只读设计(sqlite3 mode=ro、PRAGMA 不写库)、参数化 SQL、提示注入防御(把记录数据视为不可信)、最小化字段/行输出、敏感字段披露限制、多数据库时拒绝猜测并要求用户确认。扣分点:无运行验证、快速路径自动发现 ~/Documents 数据库属轻微越权面、外部快照写入路径未在本技能内强制约束。

2可靠稳定10 / 20 · 2.5/5

probe/user-tag-schema 脚本逻辑自洽,错误消息具体且可操作(加密、多候选、缺表均有明确提示),SQL 配方内部一致(Core Data 纪元、半开区间、split 汇总规则)。扣分点:静态评审无法执行;技能自身的 SQL 关键路径(如 ZFISTATEMENT、ZBUDGETTARGET 日期映射)未提交对应的测试证据,仓库测试主要覆盖 MCP 服务器而非技能配方。

3适用触发11 / 15 · 3.7/5

SKILL.md 明确触发条件与不适用范围(通用理财建议、非 Quicken 数据),场景划分清晰(余额/现金流/投资/预算/标签)。扣分点:边界依赖特定 Quicken 版本 schema 且声明为'可能不同'、无中文支持、macOS+Quicken 环境硬性前提虽已声明但无版本兼容矩阵。

4规范维护11 / 15 · 3.7/5

分层文档(SKILL.md→references→可选 docs/schema.md)、MIT 许可、SECURITY.md、ROADMAP、版本同步与发布流程、贡献者归属齐备。扣分点:references 中部分关键细节(如 ZEFFECTIVEDATENUM 映射)显式留白要求逐文件勘察,技能层无独立变更日志,维护责任集中于单一未验证发布者。

5有效结果6 / 15 · 2.0/5

设计上直接产出可复制的参数化 SQL 并附带结果报告规范(来源、日期、货币、转移处理),边际价值明显高于手动摸索 Core Data schema。扣分点:静态评审无法验证示例查询在真实文件上的正确性或完整性,部分配方依赖逐文件校验,产出仍需核对。

6证据核验4 / 10 · 2.0/5

仓库含 CI、测试脚本、npm provenance/Sigstore、MCP Registry 发布与贡献者交叉引用,可审计的第一手材料充足。扣分点:这些证据主要覆盖 MCP 服务器,技能 SQL 关键路径缺少独立可复现的第三方执行证据,静态上限之下覆盖率仍薄。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年9月10日 审查版本 119e2724a3cb 评估证据[1][2][3][4][5][6][7][8][9][10][11][12][13]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

它会修改或损坏我的 Quicken 数据吗?
不会。技能强制以只读模式(sqlite3 -readonly / mode=ro)打开数据库,禁止任何写入、迁移或修复命令;MCP 工具也只执行 SELECT。
为什么必须保持 Quicken 打开?
Quicken 在应用关闭时会对数据库文件加密,只有应用运行时数据才可读。如果探测发现数据库加密,请打开目标 Quicken 文件、等几秒后重试。
是免费的吗?需要什么权限?
MIT 许可的开源项目,免费。需要本机文件系统读取权限访问 .quicken 数据包;不需要网络访问,数据不出本机。
能否用于 Quicken Windows 或通用理财建议?
不能。仅支持 Quicken for Mac 的 Core Data SQLite 数据库,且技能描述明确不用于通用个人理财建议或非 Quicken 数据。

相关 Skills