信号财务跟踪器
用于跟踪个人财务的模型上下文协议（MCP）服务器：支出、收入和预算摘要。
特性
- 使用类别、标签和付款方式跟踪费用
- 各种来源的创纪录收入
- 设定并监控预算
- 生成财务报告和见解
- 人工智能助手的MCP集成
安装
使用pip
pip install signals-finance-tracker来源
git clone https://github.com/juandisay/signals-financial-tracker.git
cd signals-financial-tracker
pip install -e .uvx的全球安装
全局安装软件包，以便与 uvx 命令：
# Using the provided script
./install-global.sh
# Or manually
python -m build
pip install dist/signals_finance_tracker-*.whl用法
CLI接口
该软件包提供了一个命令行界面来管理您的财务：
# Show help
finance --help
# Add an expense
finance expense add --amount 25.99 --category "Food" --description "Grocery shopping"
# List expenses
finance expense list
# Add income
finance income add --amount 1000 --source "Salary" --description "Monthly salary"
# Show budget status
finance budget status作为MCP服务器运行
要作为MCP服务器运行以与AI助手集成，请执行以下操作：
# Using the provided script (recommended)
./run-finance-mcp.sh
# Using uvx directly with the local package
uvx --with-editable . signals-finance-tracker
# If the package is installed globally
uvx signals-finance-tracker环境变量
您可以使用环境变量配置应用程序：
FINANCE_DATA_DIR：用于存储应用程序数据的目录（默认：~/.signals/finance)FINANCE_DB_URL：数据库URL（默认值：sqlite:///{data_dir}/finance.db)FINANCE_LOG_LEVEL：日志记录级别（默认值：INFO)FINANCE_SEED_DEFAULTS：是否为默认数据设置种子（默认值：false)MCP_TRANSPORT：MCP的传输方法（默认值：stdio)
MCP集成
该软件包实现了模型上下文协议（MCP），用于与AI助手集成。当作为MCP服务器运行时，它提供以下工具：
- 使用筛选器查询费用
- 查询收入条目
- 查询预算
- 生成财务报告
- 分析支出模式
- 分析预算执行情况
- 生成财务建议
要与启用MCP的助手一起使用：
- 启动MCP服务器：
./run-finance-mcp.sh - 将您的AI助手连接到MCP服务器
- 向助理询问你的财务状况
发展
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Format code
black src tests
isort src tests
# Type checking
mypy src许可证
麻省理工学院