Skip to main content
Glama
ayushpaliwal1920

Expense Tracker MCP Server

README.md
# šŸ’° Expense Tracker MCP Server

A remote **Model Context Protocol (MCP) server** for managing and analyzing expenses using **Python, FastMCP, and SQLite**.

This project is mainly built for **learning purposes** to understand how MCP servers work, how tools and resources are exposed, and how an MCP server can be accessed remotely.

> āš ļø This is a learning project and is not intended to be a production-ready financial application.

Changes : 

Before => 
            if __name__ == "__main__":
                      mcp.run()

After => 
            1if __name__ == "__main__":
                    mcp.run(transport = "http" , host = "0.0.0.0" , port = 8000 )

## šŸš€ Features

- Add expenses
- View expenses
- Update expenses
- Delete expenses
- Search expenses
- Calculate total expenses
- Category-wise expense summary
- Monthly expense summary
- Overall expense summary
- MCP tools and resources
- Remote MCP server

## šŸ› ļø Tech Stack

- Python
- FastMCP
- SQLite
- uv
- MCP
- Remote/HTTP transport

## šŸ“‚ Project Structure

```text
ExpenseTracker_Mcp_Server/
│
ā”œā”€ā”€ expenseTracker/
│   ā”œā”€ā”€ main.py
│   └── categories.json
│
ā”œā”€ā”€ README.md
ā”œā”€ā”€ pyproject.toml
ā”œā”€ā”€ uv.lock
└── .gitignore