费用追踪工具

一个基于FastMCP和Streamlit的费用追踪工具,提供费用添加、列表、汇总、更新和导出功能。

  • by At0mXploit
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 At0mXploit/Trackor

使用说明

跟踪器

这是一个自定义的MCP(模型上下文协议)服务器和哑客户端,使用 FastMCP 以及Streamlit。
它提供了跟踪费用的工具,包括添加、列出、汇总、更新和导出数据。

服务器使用本地SQLite数据库(expenses.db)以及a categories.json 费用类别文件。

工具和资源

TOOLS (callable actions that perform operations):
- add_expense                 : Create a new expense entry
- get_expense                 : Fetch a single expense by ID
- list_expenses               : List expenses with optional filters
- update_expense              : Modify an existing expense
- delete_expense              : Remove one expense by ID
- delete_expenses_by_date_range : Remove all expenses within a date range
- summarize                   : Summarize expenses by category/subcategory
- get_statistics              : Return overall stats and monthly breakdown
- export_expenses             : Export all expenses in JSON or CSV format

RESOURCES (read-only data exposed by the server):
- expense://categories        : Provides the categories.json file (list of categories/subcategories)

哑MCP客户端

这是愚蠢的MCP客户端,意味着没有任何LLM(我的专业水平很差),使用MCP服务器 https://at0mxploit.fastmcp.app/manifest.dxt.

远程部署

它已经部署在 https://dumbclient-trackor.streamlit.app/ 使用Streamlit Cloud。

本地部署

streamlit run dumb_client/app.py

MCP服务器

远程部署(最简单)

它已经使用FastMCP Cloud部署,您只需拖动此DXT文件 https://at0mxploit.fastmcp.app/manifest.dxt 克劳德扩展。这会自动为Claude配置服务器,并包括所有工具和资源。(目前仅在Pro中可用)。它适用于所有不同的模型和工具,但我使用的是Claude。

地方发展

Claude连接器(远程MCP URL)仅适用于专业用户。然而, 非Pro Claude Desktop用户仍可使用此MCP服务器 通过运行a 本地代理.

此存储库包括 proxy/ 文件夹中有一个简单的FastMCP STDIO桥。

安装依赖项:

uv sync

运行MCP:

uv run main.py

运行MCP代理:

uv run proxy/main.py

如果我们想使用Inspector在MCP中测试JSON RPC调用,我们也可以:

 uv run fastmcp dev .\main.py

Claude Desktop不再自动加载原始MCP脚本。
如果您没有使用Claude Pro,则必须安装附带的桌面扩展:

npm install -g @anthropic-ai/mcpb
mcpb pack proxy/ trackor-proxy.mcpb

这将产生 trackor-proxy.mcpb.

  1. 前往设置→ 扩展→ 高级→ 安装扩展…
  2. 选择 trackor-proxy.mcpb
  3. Claude将通过本地STDIO代理加载MCP服务器。