个人支出追踪服务器

费用跟踪MCP服务器

用于跟踪Claude个人支出的模型上下文协议（MCP）服务器。此服务器提供通过SQLite数据库添加、编辑、删除、搜索和汇总费用的工具。

特性

• 添加费用：记录费用，包括日期、金额、类别、子类别和注释
• 列出费用：查看日期范围内的费用
• 编辑费用：更新现有费用的任何字段
• 删除费用：按ID删除费用条目
• 搜索费用：按关键字跨类别和注释查找费用
• 总结：按类别获取任何日期范围的支出摘要
• 自然语言：与Claude使用对话命令（例如，“添加上周500美元的纽约之旅”）

先决条件

• Python 3.8或更高版本
• Claude桌面应用程序
• uv 包管理器

安装

1.安装UV包管理器

pip install uv

2.设置项目

导航到项目文件夹并初始化：

cd /path/to/expense-tracker
uv init .

3.安装依赖项

uv add fastmcp

测试服务器

使用MCP检查器

在基于浏览器的检查器中测试您的服务器：

uv run fastmcp dev main.py

这将打开一个web界面，您可以在其中测试所有工具。

独立运行服务器

uv run fastmcp run main.py

连接到克劳德桌面

1.安装到克劳德桌面

uv run fastmcp install claude-desktop main.py

2.更新配置

找到您的完整路径 uv 可执行文件：

which uv  # On macOS/Linux
where uv  # On Windows

打开克劳德桌面设置： Settings > Developer > Edit Config

更换 command 场从 "uv" 到实际路径：

3.重新启动克劳德桌面

完全退出并重新启动Claude Desktop以使更改生效。

使用示例

连接到Claude Desktop后，您可以使用自然语言命令：

''' 增加一项新费用：上周周一至周六的纽约之旅500美元 给我看看上个月的所有开支 从数据库中删除2024年11月24日飞往纽约的航班费用 '''

项目结构

expense-tracker/
├── main.py              # MCP server code
├── categories.json      # Expense categories
├── expenses.db          # SQLite database (created automatically)
├── pyproject.toml       # UV project configuration
└── README.md            # This file

故障排除

服务器未在Claude中显示

1. 验证 uv 配置中的路径正确
2. 检查以下路径 main.py 是绝对的
3. 完全重新启动克劳德桌面
4. 检查Claude Desktop日志是否有错误

贡献

欢迎投稿！请随时提交问题或拉取请求。