Basic Expense MCP

Small FastMCP demo that tracks expenses from expenses.csv. The server registers a tool to append new rows, a read-only resource that lists the table, and a short prompt for quick summaries.

Quick Start

• Python 3.13+ with the dependencies from pyproject.toml.
• uv sync && uv run python main.py launches the server.
• uv run fastmcp run main:mcp exposes it through the FastMCP CLI for MCP clients.

Tools

• add_expense(date, category, quantity, payment_method) adds a row (creates the CSV if missing).
• resource://expenses.csv returns the formatted table via list_expenses.
• summarize_expenses offers a natural-language summary prompt.

Notes

• expenses.csv ships with sample data; delete it to start fresh.
• Keep all logic in main.py. Add tests under tests/ if you extend the project.