Trackor

🚀 Trackor

Trackor is a custom MCP (Model Context Protocol) server and dumb client developed with FastMCP and Streamlit. It offers tools for expense tracking, including adding, listing, summarizing, updating, and exporting data.

The server utilizes a local SQLite database (expenses.db) and a categories.json file to manage expense categories.

🚀 Quick Start

Tools & Resources

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)

✨ Features

Dumb MCP Client

It is a Dumb MCP Client without any LLM (I'm short on budget for the pro version). It uses the MCP Server https://at0mxploit.fastmcp.app/manifest.dxt.

Remote Deployment

It has already been deployed on https://dumbclient-trackor.streamlit.app/ using Streamlit Cloud.

Local Deployment

streamlit run dumb_client/app.py

MCP Server

Remote Deployment (Easiest)

It has already been deployed using FastMCP Cloud. You just need to drag this DXT File https://at0mxploit.fastmcp.app/manifest.dxt to the Claude Extension. This will automatically configure the server for Claude and include all tools and resources. (Currently available only in the Pro version). It's set up for various models and tools, but I use Claude.

Local Development

Claude Connectors (remote MCP URLs) are only available to Pro users. However, non - Pro Claude Desktop users can still use this MCP server by running a local proxy.

This repository includes a proxy/ folder with a simple FastMCP STDIO bridge.

Install dependencies:

uv sync

Run MCP:

uv run main.py

Run MCP Proxy:

uv run proxy/main.py

You can also use the Inspector to test JSON RPC calls in MCP:

uv run fastmcp dev .\main.py

Claude Desktop no longer auto - loads raw MCP scripts. If you're not using Claude Pro, you must install the included desktop extension:

npm install -g @anthropic-ai/mcpb

mcpb pack proxy/ trackor-proxy.mcpb

This will generate trackor-proxy.mcpb.

1. Go to Settings → Extensions → Advanced → Install Extension…
2. Select trackor-proxy.mcpb
3. Claude will load the MCP server via the local STDIO proxy.