费用追踪 MCP 服务器

一个 MCP（模型上下文协议）服务器，允许 Claude 等 AI 助手使用本地 SQLite 数据库管理个人费用——包括添加、分类、汇总和预算。

概述

该服务器提供了一组 MCP 工具，Claude（或任何兼容 MCP 的客户端）可以调用这些工具来追踪您的支出。所有数据都存储在本地的 SQLite 文件中——无需云端，无需账户。

功能

添加并管理带有类别、金额、日期和描述的费用
按日期范围或类别筛选并列出费用
按类别或月份汇总支出
设置各类别预算并查看剩余余额
将费用导出为 CSV
完全本地化——数据保留在您的机器上

MCP 工具

工具	描述	关键参数
`add_expense`	记录一笔新费用	`amount`, `category`, `description`, `date`, `currency`
`list_expenses`	列出费用（可选筛选器）	`category?`, `start_date?`, `end_date?`, `limit?`
`get_expense_summary`	按类别或月份分组的汇总总额	`group_by` (`category` 或 `month`), `start_date?`, `end_date?`
`update_expense`	按 ID 编辑现有费用	`id`, `amount?`, `category?`, `description?`, `date?`
`delete_expense`	按 ID 删除费用	`id`
`set_budget`	为类别设置月度预算限额	`category`, `monthly_limit`, `currency?`
`get_budget_status`	比较预算限额与实际支出	`month?` (默认为当前月份)
`export_expenses`	将费用导出为 CSV 字符串	`start_date?`, `end_date?`, `category?`

项目结构

expense-tracker-mcp-server/
├── main.py             # MCP server entry point (all tools)
├── expenses.db         # SQLite database (auto-created on first run)
├── pyproject.toml      # Project metadata and dependencies
├── .venv/              # Virtual environment (created by uv)
└── readme.md

先决条件

Python 3.11+
uv (推荐) 或 pip
Claude Desktop (用于连接 MCP 服务器)

安装

# Clone the repo
git clone https://github.com/your-username/expense-tracker-mcp-server.git
cd expense-tracker-mcp-server

# Initialize the project and install dependencies
uv init
uv add fastmcp

这会在项目目录内自动创建一个 .venv 文件夹。

运行服务器

fastmcp run main.py

服务器启动并通过 stdio 监听 MCP 连接。SQLite 数据库 (expenses.db) 会在首次运行时自动创建。

连接到 Claude Desktop

将以下内容添加到您的 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Learning\\Expense-Tracker-MCP-Server",
        "run",
        "fastmcp",
        "run",
        "main.py"
      ]
    }
  }
}

完全退出 Claude Desktop（系统托盘 → 退出）并重新打开。您应该会在工具面板中看到可用的费用追踪工具。

示例提示词

连接到 Claude 后，您可以说：

"今天在 Whole Foods 花了 45 美元买杂货"
"显示我本月所有的食品支出"
"我上个月在哪方面花费最多？"
"设置 300 美元的餐饮月度预算"
"我的娱乐预算还剩多少？"
"将我三月份的所有费用导出为 CSV"

开发

# Run with MCP inspector for debugging
fastmcp dev inspector main.py

许可证

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Expense Tracker MCP Server