费用跟踪工具

基于FastMCP和aiosqlite开发的费用跟踪工具,支持添加、列出和汇总费用,提供代理连接和本地/云端部署选项。

  • by GenerativeAiWithMariams
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 GenAiWithMF/RemoteMCPServer

使用说明

ExpenseTracker快速MCP项目

这是一个 开支追踪器 使用 FastMCP 和 aiosqlite。它支持 代理连接 对于像Claude这样的远程客户端,以及本地和云部署。


特性

  • 添加、列出和汇总费用
  • 异步SQLite数据库
  • 具有可选自定义类别的默认类别
  • 用于连接远程客户端的代理支持
  • 与FastMCP工具和资源完全兼容

安装

  1. 克隆存储库:
git clone https://github.com/yourusername/ExpenseTracker.git
cd ExpenseTracker
  1. 安装依赖项:
pip install fastmcp aiosqlite
  1. 可选: 确保已安装Python>=3.13。

2.️⃣ 在本地运行服务器

开发模式(热重载)

uv运行fastmcp-dev-Main.py

正常运行

uv运行fastmcp运行Main.py

服务器将于启动http://0.0.0.0:8000默认情况下。


3.️⃣ 通过代理连接Claude Desktop或其他客户端

启动代理以连接远程客户端,如Claude

uv运行fastmcp安装claude桌面proxyfile.py

或者使用Python:

从fastmcp导入fastmcp

连接到您的FastMCP云服务器

mcp=FastMCP.as_proxy( "https://Maryams.fastmcp.app/mcp", name=“Maryam服务器代理” )


### Example CLI for connecting a local proxy to Claude Desktop

```bash
# Run proxy server to connect Claude
uv run fastmcp install claude-desktop proxy-server.py
  • 这允许Claude(或其他客户端)在不需要FastMCP Pro的情况下进行连接。
  • 使用 /mcp 如果您的服务器是远程部署的,则来自FastMCP Cloud的URL。

FastMCP工具命令

增加支出

await add_expense(date="2025-11-28", amount=100.5, category="Food & Dining")

列出费用

await list_expenses(start_date="2025-11-01", end_date="2025-11-28")

汇总费用

await summarize(start_date="2025-11-01", end_date="2025-11-28", category="Food & Dining")

类别资源

categories()  # Returns JSON of default or custom categories

在FastMCP云上部署

  1. 登录 FastMCP云.
  2. 创建新项目并上传 MCPServer.py.
  3. 选择 公共 开放获取或 私有的 使用API令牌。
  4. 使用 /mcp 远程连接的URL。

备注

  • 数据库存储在临时文件夹中,以便进行写访问。
  • 在以下情况下使用默认类别 categories.json 不存在。
  • 与Claude和其他FastMCP客户端完全兼容。