财务CLI工具

一款通过AI辅助的个人财务管理命令行工具,支持多源数据导入、智能分类、预算跟踪和债务管理等功能。

  • by henrysouchien
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 henrysouchien/finance-cli

使用说明

金融cli

用于人工智能辅助财务管理的个人理财CLI和MCP服务器。

导入银行对账单(Plaid、CSV、PDF),通过规则+AI对交易进行分类, 跟踪预算、订阅、债务和净值。SQLite后端,151个MCP工具 用于Claude Code集成。

特性

  • 多源导入:简明API、CSV报表、PDF报表(AI-parsed)
  • 智能分类:关键字规则→ 供应商存储器→ 斑块状PFC→ AI回退
  • 预算跟踪:带有警报和预测的按类别预算
  • 债务管理:仪表板、支付模拟器、支出影响分析
  • 订阅检测:固定+计量经常性收费检测
  • 企业会计:损益表,附表C,预估税,1099跟踪
  • 净值追踪:余额快照、投资账户、预测
  • 151个MCP工具:AI辅助工作流程的完整Claude代码集成

快速开始

pip install -e ".[all]"     # Install with all provider extras
finance-cli setup init       # Initialize database and seed categories
finance-cli setup connect    # Link bank accounts via Plaid
finance-cli plaid sync       # Sync transactions
finance-cli daily            # Today's spending summary

安装

# Core only (categorization, budgets, reports)
pip install -e .

# With specific providers
pip install -e ".[plaid]"       # Plaid bank sync
pip install -e ".[stripe]"      # Stripe revenue tracking
pip install -e ".[mcp]"         # Claude Code MCP server
pip install -e ".[all]"         # Everything

配置

设置环境变量(或使用 .env 文件):

# Plaid (optional)
PLAID_CLIENT_ID=...
PLAID_SECRET=...
PLAID_ENV=production

# Stripe (optional)
STRIPE_API_KEY=...

# AI categorization (optional)
OPENAI_API_KEY=...
ANTHROPIC_API_KEY=...

本地MCP(克劳德代码)

claude mcp add finance-cli -- python3 -m finance_cli.mcp_local

文档

需求

  • Python 3.11+
  • SQLite(包含在Python中)

许可证

PolyForm非商业版1.0.0