使用说明
💰 费用跟踪MCP服务器
这个项目是一个使用FastMCP和SQLite构建的小型Expense Tracker服务器。 它允许您添加、列出和总结您的费用——所有这些都可以通过简单的MCP工具完成。
您可以将其用作费用跟踪应用程序的后端服务，也可以将其与其他MCP客户端连接。
🚀 特性
✅ 添加带有日期、金额、类别、子类别和注释的新费用\n ✅ 列出两个日期之间的所有费用\n ✅ 按类别汇总总费用（可选按一个类别筛选）\n ✅ 将数据存储在本地SQLite数据库中（expenses.db）\n ✅ 从categories.json文件加载自定义费用类别\n ✅ 已准备好作为MCP（模型上下文协议）服务器运行
🧩 项目结构
费用_机架_MCP_服务器/ │ ├── exposes.db#SQLite数据库文件（首次运行时自动创建） ├── categories.json#包含可用类别的json文件 ├── main.py（或服务器文件）#主MCP服务器代码 └── README.md#您在这里
安装依赖项
uv添加fastmcp安装fastmcp
如果你缺少sqlite3，请安装Python的标准库版本（在大多数设置中默认使用）。
🖥️ 如何跑步
通过运行以下命令启动MCP服务器：
python main.py
服务器将：
如果本地SQLite数据库（expenses.db）不存在，则初始化它
公开MCP工具，如add_expense、list_expenses和summary
然后，您可以从任何兼容MCP的客户端连接到此服务器。
🧠 可用的MCP工具
- add_expense（日期、金额、类别、子类别=“”，注释=“”）
添加新的支出记录。
例子：
add_expense（“2025-10-28”，250.00，“食物”，“午餐”，“与朋友一起吃披萨”）
答复：
{“状态”：“正常”，“id”：1}
- list_expenses（开始日期、结束日期）
列出两个给定日期之间的所有费用。
例子：
列表_支出（“2025-10-01”，“2025-10-31”）
答复：
[ {“id”：1，“日期”：“2025-10-28”，“金额”：250.0，“类别”：“食品”，“子类别”：《午餐》，“备注”：“与朋友一起吃披萨”} ]
总结（开始日期、结束日期、类别=无）
按类别汇总所选日期范围的费用。
例子：
总结（“2025-10-01”，“2025-10-31”）
答复：
[ {“类别”：“食品”，“总量”：250.0} ]
expense://categories（MCP资源）
返回categories.json文件的内容。
这允许您动态定义和获取类别。
🧾 示例类别.json
{ “食物”：[“早餐”、“午餐”、“晚餐”、“零食”]， “运输”：[“公共汽车”、“出租车”、“燃料”]， “娱乐”：[“电影”、“游戏”、“旅行”] }
🧱 数据库模式
列类型说明 id INTEGER自动递增主键 日期文本费用日期（YYYY-MM-DD） 实际支出金额 类别文本主要类别（例如，食品） 子类别TEXT可选子类别（例如，午餐） 备注TEXT可选备注
🧑💻 作者
阿提克·乌尔·雷曼 用于管理日常开支的轻量级简单后端——使用FastMCP和SQLite构建，用于快速集成和学习。
