# Expense Tracker MCP Proxy for Remote Server
A Model Context Protocol (MCP) proxy server that connects to a remote expense tracker FastMCP cloud server and exposes its tools locally.
> **Note:** This is a proxy server only. It connects to a remote FastMCP cloud URL and forwards requests to the actual expense tracking implementation. The source code for the expense tracking functionality is available at: [expense-tracker-remote-mcp-server](https://github.com/bhakti259/expense-tracker-remote-mcp-server)
## Features
This proxy server:
- Connects to the remote FastMCP server at `https://chronic-scarlet-urial.fastmcp.app/mcp`
- Automatically discovers and exposes all tools available on the remote server
- Forwards all tool calls to the remote server
- Provides transparent proxying with error handling
- Handles Server-Sent Events (SSE) responses from the FastMCP server
- Acts as a local stdio interface to the remote expense tracker implementation
## Remote Server Tools
The remote FastMCP server provides an **Expense Tracker** with 5 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
## Installation
1. Install dependencies:
```bash
pip install -e .
```
Or install manually:
```bash
pip install mcp aiohttp
```
## Usage
Run the server:
```bash
python main.py
```
The server communicates via stdio and follows the Model Context Protocol specification.
## Configuration
To use this server with an MCP client (like Claude Desktop), add it to your client configuration:
```json
{
"mcpServers": {
"bhakti-server-proxy": {
"command": "python",
"args": ["d:\\Python Projects\\Proxy-server\\main.py"]
}
}
}
```
Or with the full Python path:
```json
{
"mcpServers": {
"bhakti-server-proxy": {
"command": "C:\\Users\\kulsu\\AppData\\Local\\Programs\\Python\\Python314\\python.exe",
"args": ["d:\\Python Projects\\Proxy-server\\main.py"]
}
}
}
```
## Development
The server is built using the `mcp` Python library and implements:
- Tool listing from remote server
- Tool execution forwarding to remote server
- Async stdio communication
- Server-Sent Events (SSE) handling
## Testing
Test the connection to the remote server:
```bash
python test_proxy.py
```
## License
MIT
