Expense Tracker MCP Proxy

This MCP proxy forwards requests from your local environment to a remote expense-tracker MCP server, exposing its tools locally while handling errors and live event streams. It lets you manage expenses from a local client as if the implementation were running on your machine, while the actual logic runs remotely.

How to use

You connect your MCP client to the proxy to access the remote expense-tracker tools locally. The proxy automatically discovers all available remote tools and forwards tool calls to the remote server. You can create, list, update, delete, and summarize expenses through your local MCP client without needing to run the remote implementation yourself. If the remote server sends events during operation, the proxy handles them transparently so your client stays in sync.

How to install

Prerequisites you need installed on your machine:

• Python 3.x
• pip (Python package manager)

Install the proxy package dependencies either by using editable install or by installing the runtime dependencies directly.

pip install -e .

Or install manually with the runtime dependencies:

pip install mcp aiohttp
`

Start the proxy server

Run the proxy locally. It exposes the remote expense-tracker tools through a local interface.

python main.py
`

Available tools

add_expense

Add a new expense with date, amount, category, subcategory, and notes.

list_expenses

List expenses with optional filtering by category and date range.

update_expense

Update an existing expense.

delete_expense

Delete an expense.

summarize_expenses

Get expense summaries grouped by category.