Servidor MCP de Expense Tracker

Un servidor local del Model Context Protocol (MCP) para un Expense Tracker personal creado con Python y SQLite3.

Características

• add_expense — añade un gasto; reduce el crédito disponible

• list_expenses — lista los gastos (los más recientes primero), opcionalmente filtrados por categoría

• summarize_expenses — totales por categoría, recuento, crédito añadido y crédito disponible

• edit_expense — edita un gasto; ajusta el crédito según la diferencia en el importe

• delete_expense — elimina un gasto; reembolsa el importe al crédito

• add_credit — añade crédito al saldo disponible

Todas las operaciones que modifican el saldo se ejecutan dentro de transacciones de SQLite.

Related MCP server: Expense Tracker MCP Server

Estructura de carpetas

local MCP server/
├── main.py                       # MCP server + tool definitions (entry point)
├── expense_tracker/
│   ├── __init__.py
│   ├── database.py               # SQLite connection + schema setup
│   └── operations.py             # Core expense/credit business logic
├── pyproject.toml                # Project config (fastmcp dependency)
├── uv.lock                       # Lockfile
└── README.md

El archivo de base de datos expense_tracker.db se crea automáticamente en la primera llamada a la herramienta.

Instalación

Clona el repositorio:

git clone https://github.com/YogeshSharma2007/Local-Expense-tracker-MCP.git
cd Local-Expense-tracker-MCP

Crea y activa un entorno virtual:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

Instala las dependencias:

uv sync          # or: pip install -e .

Ejecutar el servidor

python main.py

A continuación, registra el servidor como un servidor MCP stdio local en tu cliente MCP.

Registro con un cliente MCP (ejemplo con OpenCode)

Añade a tu configuración de OpenCode (opencode.json o donde se encuentre la configuración de tu cliente):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "local-mcp": {
      "type": "local",
      "command": [
        "<path-to-repo>\\.venv\\Scripts\\python.exe",
        "<path-to-repo>\\main.py"
      ],
      "enabled": true
    }
  }
}

Reemplaza <path-to-repo> con la ruta completa a donde hayas clonado este repositorio, por ejemplo:

C:\Users\<your-username>\Documents\Local-Expense-tracker-MCP

Configuración

La ruta de la base de datos por defecto es expense_tracker.db en la carpeta del proyecto. Sobrescríbela con la variable de entorno:

$env:EXPENSE_TRACKER_DB = "C:\path\to\expense_tracker.db"