AI导哈

费用跟踪MCP服务器

一个轻量级的MCP服务器，用于通过自然语言管理费用，支持添加、编辑、删除、搜索、汇总和导出费用。

  • by mahik2604
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mahik2604/mcp-expense-tracker

使用说明

费用跟踪MCP服务器

轻量级 MCP（模型上下文协议）服务器 使用 FastMCP+SQLite，允许您直接通过以下方式管理费用 克劳德桌面版 使用自然语言。

该项目支持添加、编辑、删除、搜索、汇总和导出费用，所有这些都是通过Claude的工具调用触发的。

🚀 特性

  • 添加、列出、编辑和删除费用
  • 添加积分（收入跟踪）
  • 基于类别的摘要
  • 月度总结
  • 按关键字搜索费用
  • 查看最近的支出
  • 将费用导出到CSV
  • SQLite支持的轻量级存储
  • 与Claude Desktop MCP完全兼容

📦 项目结构

费用跟踪mcp服务器/ │ ├── main.py#MCP服务器实现 ├── categories.json#费用类别 ├── exposes.db#SQLite数据库（通过.gitignore忽略） ├── README.md ├── pyproject.toml ├── uv.lock Mabalin遇到了i-print学生。 └── .venv/#uv管理虚拟环境

🛠 安装说明

1.初始化项目（已完成）

紫外线初始化。

2.安装FastMCP

uv添加fastmcp

3.激活虚拟环境

.venv\Scripts\activate.bat

4.验证安装

fastmcp版本

▶ 在开发模式下运行服务器

使用 uv 运行FastMCP的开发服务器：

uv运行fastmcp-dev-main.py

这将启动MCP服务器并监视文件更改。

🧩 将MCP服务器添加到Claude桌面

运行：

uv运行fastmcp安装claude桌面main.py

这将自动向Claude Desktop注册您的服务器。
重新启动Claude Desktop以加载MCP工具。

🧪 测试MCP工具（示例）

直接在Claude Desktop中尝试以下操作：

增加以下费用₹250 在2025-01-10的“食物”中，注明“午餐”。 增加差旅费₹1200 2025年2月1日，优步。 将最后一笔优步费用编辑为₹1200. 删除我上次的伙食费。 显示我从2025年1月1日到2025年2月10日的支出。 使用关键字“pizza”搜索费用。 展示我2025年2月的总结。 将我的所有费用导出到CSV。

🧰 可用工具（API）

核心工具

  • add_expense
  • list_expenses
  • summarize

编辑/删除

  • edit_expense
  • delete_expense

积分和余额

  • add_credit
  • total_money

发现工具

  • list_all_expenses
  • list_by_category
  • list_recent
  • search_expense

分析

  • monthly_summary

出口

  • export_csv

资源

  • expense://categories

📜 许可证

MIT许可证

🙌 致谢

使用 FastMCP 并用 克劳德桌面MCP 整合。

相关 MCP