Math I Choose to Ignore (MCP Server)

Because your bank account won't ignore it forever.

Math I Choose to Ignore is an AI-powered expense tracking server built using the Model Context Protocol (MCP). It connects LLM clients (like Claude Desktop) directly to your PostgreSQL database, transforming your AI assistant into a personal financial analyst that can track, categorize, summarize, and manage your spending through natural language.

---

Features

• Natural Language Ledger: Add, edit, delete, and query your expenses just by chatting with Claude.
• Robust PostgreSQL Integration: Uses strict financial schema design (NUMERIC(10,2) for currency precision, native DATE types, and SERIAL primary keys).
• Safe Dynamic Querying: Built-in SQL injection prevention using parameterized queries and dynamic condition building.
• Built with FastMCP: Exposes both MCP Tools (for database actions) and MCP Resources (for read-only context like expense categories).
• Isolated Environment: Clean dependency management using uv.

---

Tech Stack

• Language: Python
• MCP Framework: fastmcp
• Database: PostgreSQL (psycopg / psycopg2)
• Package Manager: uv

---

Getting Started

1. Prerequisites

• Python 3.10+
• uv package manager
• PostgreSQL installed and running
• Claude Desktop (for client integration)

2. Installation & Setup

Clone the repository and install dependencies:

git clone [https://github.com/yourusername/math-i-choose-to-ignore.git](https://github.com/yourusername/math-i-choose-to-ignore.git)
cd math-i-choose-to-ignore
uv venv
uv sync

---

Database Configuration

 DB_URL = "dbname=yourdbname user=yourusername password=yourpassword host=localhost port=5432"

---

Testing with MCP Inspector

uv run fastmcp dev inspector main.py

---

Claude Desktop Integration

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "Math I Choose to Ignore": {
      "command": "C:\\Users\\YourUsername\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\YourUsername\\Desktop\\MCP\\math_i_choose_to_ignore",
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "C:\\Users\\YourUsername\\Desktop\\MCP\\math_i_choose_to_ignore\\main.py"
      ]
    }
  }
}

Important: After updating the JSON file, fully quit Claude Desktop from your Windows system tray and restart it.

---

Available MCP Tools And Resources

Tools (Actions)

Tool	Description
add_expense	Adds a new expense with date, amount, category, subcategory, and optional notes.
list_exp	Lists all expenses within an inclusive YYYY-MM-DD date range.
summarize	Groups and sums expenses by category over a date range (optional category filter).
edit_exp	Updates an existing expense amount or record.
delete_exp	Safely removes an expense entry from the ledger.

Resources (Read-Only Context)

Resource URI	Description
expense://categories	Exposes standard budget categories from a local JSON file so the AI knows valid categorization options.