用途:通过命令行管理 Firefly III 个人财务系统,基于 CLI-Anything 规范,将 MCP 模式转为无状态 CLI 模式,避免 Node 残留进程问题。
安装与前置:pip install cli-anything-firefly-iii;需 Python 3.10+、运行中的 Firefly III 实例、Personal Access Token(PAT)。
配置:推荐环境变量 export FIREFLY_III_BASE_URL="https://firefly.yourdomain.com" 与 export FIREFLY_III_PAT="your-personal-access-token";也可用参数 cli-anything-firefly-iii --base-url ... --pat ...。
主要能力:命令组覆盖 accounts、transactions、budgets(含 limits)、categories、tags、bills、piggy-banks(含 events)、autocomplete、currencies、recurrences、rules(含 test/execute)、rule-groups、summary、webhooks、insights、search、export、info,分别对应 Firefly III 的 /api/v1 相关接口。
使用方式:命令支持 --json 输出结构化数据;可用 --preset 过滤命令集,预设包括 default、full、basic、budget、reporting、admin、automation。建议先执行 cli-anything-firefly-iii info status 检查连接,再执行操作。示例:cli-anything-firefly-iii --json accounts list --type asset;cli-anything-firefly-iii --json transactions create --description "Grocery" --amount 50.00 --source-account 1 --category "Food"。
适用场景:脚本化记账、批量查询与导出、预算与报表生成、规则自动化、Webhook 管理等。
限制:需自备可访问的 Firefly III 实例与有效 PAT;日期格式为 YYYY-MM-DD,货币代码为 ISO 4217;错误处理涉及连接、认证、资源不存在、参数与校验错误。资料未提供收费、价格、平台支持范围及性能数据。