Trackor

🚀 Trackor

Trackor是一個自定義的MCP（模型上下文協議）服務器和簡單客戶端，使用 FastMCP 和Streamlit構建。它提供了用於跟蹤費用的工具，包括添加、列出、彙總、更新和導出數據等功能。服務器使用本地SQLite數據庫（expenses.db）和 categories.json 文件來管理費用類別。

🚀 快速開始

Trackor可進行遠程部署和本地部署，以下是詳細的部署步驟。

簡單MCP客戶端部署

遠程部署

該客戶端已通過Streamlit Cloud部署到 https://dumbclient-trackor.streamlit.app/，可直接訪問使用。

本地部署

在本地環境中，使用以下命令啟動客戶端：

streamlit run dumb_client/app.py

MCP服務器部署

遠程部署（最簡單方式）

服務器已使用FastMCP Cloud進行部署。你只需將DXT文件 https://at0mxploit.fastmcp.app/manifest.dxt 拖到Claude擴展程序中，它會自動為Claude配置服務器，幷包含所有工具和資源（目前僅專業版可用）。此配置適用於所有不同的模型和工具，這裡以Claude為例。

本地開發

Claude連接器（遠程MCP URL）僅對專業版用戶可用。不過，非專業版的Claude桌面用戶仍可通過運行本地代理來使用此MCP服務器。

此倉庫包含一個 proxy/ 文件夾，其中有一個簡單的FastMCP STDIO橋接器。具體操作步驟如下：

1. 安裝依賴：

uv sync

2. 運行MCP：

uv run main.py

3. 運行MCP代理：

uv run proxy/main.py

4. 使用檢查器測試MCP中的JSON RPC調用（可選）：

uv run fastmcp dev .\main.py

由於Claude桌面版不再自動加載原始MCP腳本，如果你未使用Claude專業版，則必須安裝包含的桌面擴展：

npm install -g @anthropic-ai/mcpb

mcpb pack proxy/ trackor-proxy.mcpb

上述命令將生成 trackor-proxy.mcpb 文件，然後按以下步驟操作：

1. 轉到設置 → 擴展 → 高級 → 安裝擴展…
2. 選擇 trackor-proxy.mcpb 文件
3. Claude將通過本地STDIO代理加載MCP服務器。

✨ 主要特性

工具與資源

Trackor提供了一系列工具和資源，用於管理和操作費用數據，具體如下：

工具（可調用的操作）

• add_expense：創建新的費用條目
• get_expense：通過ID獲取單個費用信息
• list_expenses：列出費用，支持可選過濾條件
• update_expense：修改現有費用信息
• delete_expense：通過ID刪除單個費用
• delete_expenses_by_date_range：刪除指定日期範圍內的所有費用
• summarize：按類別/子類別彙總費用
• get_statistics：返回總體統計信息和每月明細
• export_expenses：以JSON或CSV格式導出所有費用數據

資源（服務器公開的只讀數據）

• expense://categories：提供 categories.json 文件（類別/子類別列表）