Expense Tracker MCP

一个使用 FastMCP 构建的远程 Model Context Protocol (MCP) 服务器，可让 Claude 等 AI 助手通过结构化工具与费用追踪系统进行交互。

🚀 概述

本项目展示了 AI 助手如何通过 MCP 与外部数据和应用程序功能进行交互。

Expense Tracker MCP 服务器使用 FastMCP 公开费用管理工具，并使用 SQLite 存储费用数据。

该服务器使用 FastMCP Cloud 远程部署，允许 Claude 等 MCP 兼容客户端通过远程 MCP 端点连接。

Related MCP server: Expense Tracker MCP

🏗️ 架构

Claude
   │
   │ MCP
   ▼
Remote MCP Endpoint
   │
   ▼
FastMCP Cloud
   │
   ▼
FastMCP Expense Tracker Server
   │
   ▼
SQLite Database

✨ 功能

• 添加和管理费用

• 检索费用记录

• 对费用进行分类

• 使用 SQLite 存储费用数据

• 通过 MCP 工具公开费用功能

• 远程部署 MCP 服务器

• 将远程 MCP 服务器连接到 Claude

• 让 AI 助手与结构化费用数据交互

🛠️ 技术栈

• Python

• FastMCP

• Model Context Protocol (MCP)

• SQLite

• JSON

• FastMCP Cloud

• Claude

🔌 示例交互

连接到 Claude 后，用户可以使用自然语言与费用追踪器交互。

"Add an expense of ₹500 for groceries."

"Show me my recent expenses."

"How much did I spend on food?"

"List my expenses by category."

Claude 会理解用户的请求，并调用服务器公开的相应 MCP 工具。

☁️ 远程部署

MCP 服务器部署在 FastMCP Cloud 上，并通过远程 MCP 端点公开。

这使 Claude 和其他兼容 MCP 的客户端无需在本地运行服务器即可访问它。

Local Development
       ↓
FastMCP Server
       ↓
FastMCP Cloud
       ↓
Remote MCP Endpoint
       ↓
Claude

⚙️ 本地设置

克隆仓库：

git clone https://github.com/khushisonwane23/expense-tracker-mcp.git
cd expense-tracker-mcp

创建虚拟环境：

python -m venv .venv

在 Windows 上激活虚拟环境：

.venv\Scripts\activate

安装依赖项：

pip install -r requirements.txt

如果你使用 uv：

uv sync

▶️ 本地运行

运行 FastMCP 服务器：

fastmcp run server.py

确切命令可能取决于项目配置。

🔗 连接到 Claude

将服务器部署到 FastMCP Cloud 后，应用程序会提供一个远程 MCP 端点。

该端点可以在 Claude 等 MCP 兼容客户端中配置。

Claude
   ↓
Remote MCP Endpoint
   ↓
FastMCP Cloud
   ↓
Expense Tracker MCP Server
   ↓
SQLite Database

连接后，Claude 可以发现并使用 MCP 服务器公开的工具。

🔐 安全性

敏感信息绝不应提交到此仓库。

以下文件应保持私密：

.env
expenses.db
.venv/
__pycache__/

API 密钥和其他机密信息应使用环境变量存储，而不是硬编码在源代码中。

🎯 学习目标

构建此项目是为了理解：

• Model Context Protocol 的工作原理

• AI 助手如何与外部工具交互

• 如何使用 FastMCP 构建 MCP 服务器

• 如何将 LLM 与外部数据连接

• 基于工具的 AI 工作流如何工作

• 如何远程部署 MCP 服务器

• MCP 如何与 Claude 集成

🚀 未来改进

• 添加身份验证和授权

• 添加月度支出分析

• 添加预算跟踪

• 添加更丰富的财务洞察

• 改进错误处理和输入验证

• 添加自动化测试

• 使用生产级数据库

• 添加更多财务管理工具

👩💻 作者

Khushi Sonwane

人工智能与机器人技术专业学生

对 Generative AI, AI Agents, MCP, RAG, and AI Research 感兴趣。