使用说明
费用跟踪MCP服务器
A. 模型上下文协议（MCP）服务器 这使得克劳德等人工智能助手能够使用自然语言管理个人开支。 此服务器公开了用于添加、列出、汇总、编辑和删除费用的工具，同时使用结构化类别和子类别对其进行组织。
该项目演示了AI代理如何使用MCP与外部工具和数据库进行交互。
特性
- 添加新费用
- 列出日期范围内的费用
- 按类别汇总支出
- 编辑现有费用记录
- 删除费用记录
- 类别和子类别验证使用
categories.json - SQLite数据库存储
- 类别的MCP资源，以便AI助手能够理解有效的支出类型
项目结构
expense-mcp-server
│
├── main.py # MCP server implementation
├── categories.json # Expense categories and subcategories
├── expenses.db # SQLite database (auto-generated)
├── requirements.txt # Python dependencies
├── .gitignore
└── README.md
使用的技术
- python
- FastMCP
- SQLite
- 模型上下文协议（MCP）
安装
克隆存储库：
git clone https://github.com/your-username/expense-mcp-server.git
cd expense-mcp-server
创建并激活虚拟环境：
python -m venv .venv
.venv\Scripts\activate
安装依赖项：
pip install -r requirements.txt
运行MCP服务器
启动服务器：
uv run fastmcp dev inspector main.py
uv run fastmcp run main.py
Claude Desktop或任何兼容MCP的客户端现在都可以连接到服务器并使用可用的工具。--uv运行fastmcp安装claude桌面main.py
可用的MCP工具
增加支出
添加新的支出条目。
示例参数：
{
"date": "2026-03-07",
"amount": 500,
"category": "education",
"subcategory": "courses",
"note": "Udemy course"
}
列出费用
检索两个日期之间的所有费用。
例子：
{
"start_date": "2026-03-01",
"end_date": "2026-03-31"
}
汇总费用
按类别汇总总支出。
例子：
{
"start_date": "2026-03-01",
"end_date": "2026-03-31"
}
编辑费用
更新现有的支出记录。
例子：
{
"expense_id": 1,
"date": "2026-03-07",
"amount": 600,
"category": "education",
"subcategory": "courses",
"note": "Updated Udemy course price"
}
删除费用
删除费用条目。
例子：
{
"expense_id": 1
}
类别资源
MCP服务器公开了一个资源：
expense://categories
这允许AI助手访问中定义的有效类别和子类别列表 categories.json.
AI交互示例
用户提示：
Add 500 rupees for a Udemy course on March 7
AI呼叫：
add_expense(
date="2026-03-07",
amount=500,
category="education",
subcategory="courses",
note="Udemy course"
)
未来改进
- 从自然语言中自动检测类别
- 月度分析和支出洞察
- 预算警报和建议
- 使用云托管进行远程MCP部署
- 用于费用可视化的Web仪表板
