费用追踪服务器

费用跟踪MCP服务器

用于跟踪个人支出的模型上下文协议（MCP）服务器。此服务器提供添加、列出和汇总费用的工具，利用本地SQLite数据库进行存储。

特性

• 添加费用：记录费用，包括金额、类别、子类别、日期和备注等详细信息。
• 列出费用：检索指定日期范围内的费用列表。
• 汇总费用：生成按类别分组的费用汇总（总金额）。
• 类别资源：访问预定义支出类别的综合列表。
• 本地数据库：所有数据都存储在本地 expenses.db 文件。

先决条件

• python 3.13或更高
• 紫外线 （推荐）或 pip

安装

1. 克隆仓库 （如果适用）或导航到项目目录：

   复制

   cd "d:\Study\Expense Tracker MCP"
   

2. 安装依赖项:

   使用 uv:

   复制

   uv sync
   

   或使用 pip:

   复制

   pip install -e .
   

用法

本地运行

您可以在本地运行MCP服务器进行测试或开发。

开发模式（自动重新加载）：

uv run fastmcp dev main.py

生产运行：

uv run fastmcp run main.py

检查员

您可以使用MCP检查器检查和测试服务器工具：

uv run fastmcp inspect main.py

与Claude Desktop集成

要在Claude Desktop上使用此费用跟踪器，请执行以下操作：

1. 打开您的Claude Desktop配置文件：

   • 视窗: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加 expense-tracker 服务器到 mcpServers 对象。确保使用 绝对路径 到你的 main.py 文件。

   复制

   {
     "mcpServers": {
       "expense-tracker": {
         "command": "uv",
         "args": [
           "run",
           "fastmcp",
           "run",
           "d:/Study/Expense Tracker MCP/main.py"
         ]
       }
     }
   }
   

3. 重新启动克劳德桌面。

可用工具

add_expense

添加新的支出条目。

• 参数:
  • amount （浮动）：费用的成本。
  • category （string）：费用类别（参见 categories 资源）。
  • subcategory （字符串，可选）：更具体的分类。
  • note （字符串，可选）：其他详细信息。
  • date （字符串，可选）：支出日期 DD-MM-YYYY 格式。如果省略，则默认为当前日期（IST）。

list_expenses

列出日期范围内的费用。

• 参数:
  • start_date （string）：开始日期 DD-MM-YYYY 格式。
  • end_date （string）：结束日期 DD-MM-YYYY 格式。

summarize

按类别汇总费用。

• 参数:
  • start_date （string）：开始日期 DD-MM-YYYY 格式。
  • end_date （string）：结束日期 DD-MM-YYYY 格式。
  • category （字符串，可选）：按特定类别筛选。

资源

expense://categories

返回可用支出类别的JSON内容。

项目结构

• main.py：核心MCP服务器实现。
• expenses.db：SQLite数据库文件（自动创建）。
• categories.json：特定类别配置。
• pyproject.toml：项目配置和依赖关系。

备注

• 日期格式：系统使用 DD-MM-YYYY 用于数据存储和查询。
• 时区：默认日期以印度标准时间（IST）计算。