支出追踪服务

费用追踪器MCP服务器

一 MCP（模型上下文协议）服务器 用……建造/构建 FastMCP 帮助您追踪和分析个人开销。
这台服务器旨在与（以下设备或系统）一起使用 MCP兼容客户端 如，诸如 克劳德桌面版并为费用管理提供结构化的工具和资源。

🧾 概述

费用追踪器MCP服务器允许MCP客户端：

• 添加新费用 （包含日期、金额、类别、子类别和备注）
• 列出费用 在给定的日期范围内
• 总结支出 在给定时间段内按类别划分
• 访问预定义类别 来自JSON资源

所有费用数据都存储在本地 SQLite 数据库 (expenses.db）。 类别可以通过（系统/平台）进行管理 categories.json 文件。

📂 项目结构

.
├── categories.json # Predefined expense categories
├── expenses.db # SQLite database (auto-created on first run)
├── main_exp.py # Main MCP server
├── demo.py # Optional demo / quick test script
├── pyproject.toml # Project metadata & dependencies
├── uv.lock # Lock file for uv dependencies
└── README.md # You are here

🚀 功能特点

• 添加费用 → 通过分类、子分类和备注节省开支
• 列出费用 → 提取开始日期和结束日期之间的费用
• 总结 → 按类别汇总费用（可选：按一个类别过滤）
• 动态类别 → 类别实时加载自 categories.json 这样你就可以编辑而无需重启
• 由FastMCP提供支持/驱动 → 简单、声明式的工具，无需任何样板代码

🛠 设置与运行

1. 克隆仓库

git clone https://github.com/AbhaySingh71/Expense-tracker-mcp-server.git
cd Expense-tracker-mcp-server

2. 使用 uv 安装依赖项

uv sync

3. 运行MCP服务器

uv run main_exp.py

服务器将启动并等待MCP客户端（如Claude Desktop）连接。

🖥 与Claude（MCP客户端）一起使用

打开您的Claude桌面配置文件（claude_desktop_config.json）。

在下方添加费用追踪器MCP服务器 "mcpServers"示例：

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": ["run", "main_exp.py"],
      "cwd": "C:/Users/abhay/Desktop/Expense-tracker-mcp"
    }
  }
}

重启 Claude 桌面版。
现在你可以向Claude询问诸如：

• “在2025年9月28日添加200卢比的食品费用。”
• “列出我2025年9月1日至2025年9月28日期间的所有支出。”
• “请按类别汇总我2025年9月的支出。”

🔍 使用MCP Inspector进行调试

你也可以使用MCP Inspector在Claude外部测试这台服务器。

示例：

npx @modelcontextprotocol/inspector uv run main_exp.py

这将在您的浏览器中启动检查器用户界面，您可以在其中尝试各种工具（add_expense， list_expenses， summarize) 并检查资源 (expense://categories) 以交互方式。

📬 贡献（或：参与贡献）

欢迎提交拉取请求和功能建议。
遵循MCP设计哲学：模块化、清晰性、可扩展性。

🛡 许可证

根据MIT许可证发布。