费用追踪服务

💰 费用跟踪MCP服务器

一 费用跟踪器MCP（模型上下文协议） 与无缝集成的服务器 Claude桌面版，允许您 跟踪、汇总和管理费用 通过自然语言。

此MCP服务器是使用 FastMCP 和 SQLite，提供了一个轻量级的本地财务管理后端，Claude可以直接与之对话。

🚀 特性

• 🧾 添加新的支出记录
• 📅 列出任何日期范围内的费用
• 📊 按类别或时间段汇总总费用
• 📂 持久SQLite数据库(expenses.db)自动创建
• ⚙️ 易于集成 Claude桌面应用程序 作为MCP连接器
• 🪶 轻量级（纯Python，无需外部数据库）

🧠 运作原理

Claude Desktop使用 模型上下文协议（MCP） 与外部工具进行通信。
此Expense Tracker充当本地MCP服务器，提供以下工具：

📁 项目结构

expense-tracker-mcp/
│
├── main.py               # MCP server script
├── categories.json        # Predefined expense categories
├── expenses.db            # SQLite database (auto-created)
├── requirements.txt       # Dependencies
└── README.md              # Project documentation

⚙️ 安装和设置

1.️⃣ 克隆存储库

git clone https://github.com/tausifdev/expense-tracker-mcp.git
cd expense-tracker-mcp

2.️⃣ 再进行

使用 紫外线 （推荐）：

uv run --with fastmcp python main.py

或者使用pip：

pip install fastmcp

3.️⃣ 验证数据库初始化

当服务器首次运行时，它会自动创建 expenses.db 在同一个目录中。

🖥️ 与Claude Desktop集成

要将此Expense Tracker与Claude连接，请将以下内容添加到您的 claude_desktop_config.json （发现于 %AppData%\Claude\ 在Windows上）：

{
  "mcpServers": {
    "ExpenseTracker": {
      "command": "C:/Users/Tausif/anaconda3/Scripts/uv.exe",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "python",
        "C:/Users/Tausif/OneDrive/Desktop/Projects/expense-tracker-mcp/main.py"
      ],
      "env": {},
      "transport": "stdio"
    }
  }
}

然后重新启动Claude Desktop。
你会看到的 费用追踪器 列在下面 设置→ 连接器→ 自定义MCP服务器。

🧩 Claude命令示例

你现在可以这样和克劳德说话：

💬 “增加费用₹500 2025年10月22日的食品类别。”
💬 “显示10月1日至10月31日期间的所有费用。”
💬 “按类别总结我本月的支出。”

Claude将使用此MCP连接器查询和更新您的本地SQLite数据库。

🧰 需求

• Python≥3.10
• SQLite（与Python捆绑在一起）
• FastMCP封装
• （可选） 紫外线 用于轻量级依赖管理

📊 SQL输出示例

🧾 许可证

该项目根据 MIT许可证.
您可以根据相同的条款自由修改和分发。

👨‍💻 作者

陶西夫·拉赫曼中士
亚马逊软件开发工程师1
💼 重点：云、AI/ML和GenAI系统
🌐 GitHub

🌟 致谢

• FastMCP
• 克劳德Anthropic
• SQLite
• 灵感来自开源 Manim MCP服务器

“让你的数据讲述你的故事——然后你的克劳德会自动完成它。” ✨