费用跟踪MCP服务器（本地）
基于FastMCP的费用跟踪服务器，使AI助手能够添加、列出和汇总存储在本地SQLite数据库中的个人费用，并进行类别管理。
特性
- 💰 添加费用：记录带有日期、金额、类别、子类别和注释的交易
- 📊 列出费用：查看日期范围内的所有费用
- 📈 总结：获取任何时期的分类支出摘要
- 🏷️ 类别资源：访问20多个预定义的费用类别及其子类别
- 💾 本地SQLite存储：本地存储的所有数据
expenses.db - 🔧 FastMCP集成：与Claude Desktop和其他MCP客户端无缝集成
安装
先决条件
- Python 3.12+
- 紫外线 包管理器
- Claude Desktop（用于MCP集成）
设置
- 克隆存储库：
git clone https://github.com/Rahul4112002/Expense-Tracker-MCP-Server-Local-.git
cd expense-tracker-mcp-server- 安装依赖项（由自动处理
uv):
uv sync- 配置Claude桌面：
编辑您的Claude Desktop配置文件：
- 视窗:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
添加以下配置：
{
"mcpServers": {
"ExpenseTracker": {
"command": "uv",
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"/absolute/path/to/expense-tracker-mcp-server/main.py"
],
"env": {},
"transport": "stdio"
}
}
}Windows用户注意事项：在路径中使用正斜杠，并提供完整路径 uv.exe:
{
"mcpServers": {
"ExpenseTracker": {
"command": "D:/Python/Scripts/uv.exe",
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"D:/AI/MCP/expense-tracker-mcp-server/main.py"
],
"env": {},
"transport": "stdio"
}
}
}- 完全重新启动Claude Desktop（检查系统托盘以确保其完全关闭）
用法
配置后，您可以使用自然语言通过Claude Desktop与费用跟踪器进行交互：
添加费用
Add an expense: $45.50 for groceries on 2025-11-13列出费用
Show me all expenses from 2025-11-01 to 2025-11-13获取摘要
Summarize my spending by category from 2025-11-01 to 2025-11-13查看类别
What expense categories are available?可用工具
add_expense
在数据库中添加新的支出条目。
参数：
date（字符串，必填）：YYYY-MM-DD格式的日期amount（浮动，必填）：费用金额category（字符串，必填）：费用类别subcategory（字符串，可选）：子类别note（字符串，可选）：附加注释
退货： {"status": "ok", "id": }
list_expenses
列出包含日期范围内的费用条目。
参数：
start_date（字符串，必填）：开始日期（YYYY-MM-DD）end_date（字符串，必填）：结束日期（YYYY-MM-DD）
退货： 费用词典列表
summarize
按日期范围内的类别汇总费用。
参数：
start_date（字符串，必填）：开始日期（YYYY-MM-DD）end_date（字符串，必填）：结束日期（YYYY-MM-DD）category（字符串，可选）：按特定类别筛选
退货： 总金额类别摘要列表
可用类别
服务器包括20个预定义的费用类别：
- 🍔 食物 -杂货、餐饮、咖啡、小吃
- 🚗 运输 -燃料、公共交通、出租车、停车
- 🏠 住房 -租金、维护、修理
- ⚡ 公用事业 -电、水、互联网、移动
- 🏥 健康 -药品、就诊、健身
- 📚 教育 -书籍、课程、订阅
- 👨👩👧👦 family_kids -学费、日托、衣服
- 🎬 娱乐 -电影、流媒体、游戏
- 🛍️ 购物 -服装、电子产品、电器
- 💳 订阅 -SaaS、云服务、流媒体
- 💅 个人护理 -沙龙、美容、化妆品
- 🎁 礼品_捐赠 -礼物、慈善、节日
- 💰 财务费用 -银行手续费、利息、手续费
- 💼 商业 -软件、托管、营销
- ✈️ 旅行 -航班、酒店、签证
- 🏡 家 -家居用品、维修
- 🐾 宠物 -食物、兽医、美容
- 📄 税 -所得税、商品及服务税、申报费
- 📊 投资 -共同基金、股票、加密货币
- 📦 杂项 -未分类费用
每个类别都定义了多个子类别 categories.json.
数据库模式
CREATE TABLE expenses(
id INTEGER PRIMARY KEY AUTOINCREMENT,
date TEXT NOT NULL,
amount REAL NOT NULL,
category TEXT NOT NULL,
subcategory TEXT DEFAULT '',
note TEXT DEFAULT ''
)发展
独立运行服务器：
uv run --with fastmcp fastmcp run main.py修改类别：
编辑 categories.json 添加/修改费用类别和子类别。
文件结构
expense-tracker-mcp-server/
├── main.py # Main MCP server code
├── pyproject.toml # Project dependencies
├── categories.json # Expense categories definition
├── expenses.db # SQLite database (auto-created)
├── README.md # This file
└── .venv/ # Virtual environment (auto-created)故障排除
服务器未出现在Claude Desktop中
- 验证配置路径：确保编辑的内容正确
claude_desktop_config.json - 检查路径格式：使用正斜杠
/而不是反睫毛\ - 使用绝对路径：为两者提供完整的路径
uv和main.py - 完全重新启动：重新打开之前，请从系统托盘中关闭Claude Desktop
- 检查日志：查找Claude Desktop日志中的错误
查找uv路径（Windows）：
where uv测试服务器：
uv run --with fastmcp fastmcp run main.py如果服务器启动并在横幅中显示“ExpenseTracker”，则服务器代码正在工作。
许可证
麻省理工学院
作者
由...创建 拉胡尔
贡献
欢迎投稿！请随时提交拉取请求。