💰 Expense Tracker MCP + Google ADK Agent

This project connects a Google ADK Agent with a FastMCP server --> local to manage an SQLite-based Expense Tracker.

The agent can:

• ➕ Add expense

• 📋 List expenses

• ✏️ Update expense

• ❌ Delete expense

• 📊 Sum expenses

• 🗂 Filter by category

• 📅 Filter by date range

• 🤖 Execute dynamic queries

• 🎲 Auto-generate multiple expenses

🏗 Project Structure

⚙️ Requirements

• Python 3.10+

• pip or uv

• Virtual environment (recommended)

• Groq or OpenAI API Key

🚀 Setup Instructions

1️⃣ Clone the Repository

cd Expense-tracker-MCP

Related MCP server: Expense Tracker MCP Server

2️⃣ create vertual Environment

python -m venv .venv

3️⃣ Activate Virtual Environment

.venv\Scripts\activate

4️⃣ Install Dependencies

pip install fastmcp google-adk litellm groq python-dotenv fastmcp

5️⃣ Run the ADK Agent

adk run my_agent

pip install fastmcp psutil platformdirs psutil system information ke liye use hoga.

🖥️ FastMCP System Monitor

A FastMCP server tool to monitor your system information. You can fetch battery, RAM, CPU, disk, and OS info remotely via an MCP client like Claude Desktop.

🚀 Features

• Get Battery status (percentage & charging).

• Get RAM usage (total, used, percentage).

• Get Disk usage (total, used, free space).

• Get CPU usage (percentage).

• Get System info (OS, hostname, processor).

• Accessible via HTTP MCP server, compatible with Claude Desktop or other MCP clients.

📦 Requirements

• Python 3.10+

• Libraries:

pip install fastmcp psutil platformdirs

📄 Installation

1. Clone or download this repository.

2. Ensure Python and required libraries are installed.

3. Place the file system_mcp_server.py in a suitable location.

⚙️ Usage

1. Run the MCP server

cd expense-tracker-mcp
uv run laptop_status.py

• By default, the server starts on HTTP port 8004.

• You can change the port in the main() function:

mcp.run(transport="http", port=YOUR_PORT)

2. Using with Claude Desktop

1. Open Claude Desktop.

2. Add the MCP server in the config file:

{
  "mcpServers": {
    "proxy": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "C:\\Users\\MM0956\\Documents\\Expense-tracker-MCP\\proxy.py"
      ],
      "env": {},
      "transport": "stdio",
      "type": null,
      "cwd": null,
      "timeout": null,
      "description": null,
      "icon": null,
      "authentication": null
    }
  }
}

or you can run this command to add this configuration directly by vscode terminal

cd expense-tracker-mcp
uv run fastmcp install claude-desktop .\proxy.py

3. Restart Claude Desktop.

4. Query your system using natural language:

• "Check my battery"

• "What is my RAM usage?"

• "Show disk space"

• "Show CPU usage"

• "Give me system info"

🛠️ Tools / Endpoints