MCP Expense Tracker

费用跟踪MCP服务器

用于跟踪费用的模型上下文协议（MCP）服务器，由以下组件构建 fastmcp.

特性

此服务器提供工具来管理本地SQLite数据库中的费用(expenses.db)并通过资源公开类别。

工具

• add_expense：添加新费用。

- 论据： date （YYYY-MM-DD）， amount, category, subcategory （可选）， note （可选）。

• list_expenses：列出日期范围内的费用。

- 论据： start_date, end_date.

• summarize：按类别汇总费用。

- 论据： start_date, end_date, category （可选过滤器）。

• edit_expense：编辑现有费用。

- 论据： id, date, amount, category, subcategory, note.

• delete_expense：按ID删除支出。

- 论据： id.

• add_credit：将信用添加到用户帐户（默认用户）。

- 论据： amount, user_name （可选，默认值=“默认”）。

资源

• expense://categories：返回以下内容 categories.json.

先决条件

• Python>=3.12
• uv （建议用于依赖关系管理）

安装与使用

使用 uv （推荐）

您可以直接使用以下命令运行服务器 uv:

uv run main.py

手动安装

1. 创建虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

1. 安装依赖项：

   pip install fastmcp

1. 运行服务器：

   python main.py

Claude桌面配置

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "c:\\Users\\LOQ\\Downloads\\ExpenseTracker_MCP_Server\\main.py"
      ]
    }
  }
}

*注意：将路径更新为 main.py 以匹配您的本地路径。*