Servidor MCP de Seguimiento de Gastos

Un servidor MCP (Model Context Protocol) que permite a asistentes de IA como Claude gestionar gastos personales —añadir, categorizar, resumir y presupuestar— usando una base de datos SQLite local.

Descripción general

Este servidor expone un conjunto de herramientas MCP que Claude (o cualquier cliente compatible con MCP) puede llamar para realizar un seguimiento de tus gastos. Todos los datos se almacenan localmente en un archivo SQLite; no se requiere nube ni cuenta.

Características

• Añadir y gestionar gastos con categorías, importes, fechas y descripciones

• Filtrar y listar gastos por rango de fechas o categoría

• Resumir gastos por categoría o mes

• Establecer presupuestos por categoría y comprobar los saldos restantes

• Exportar gastos a CSV

• Totalmente local: los datos permanecen en tu máquina

Herramientas MCP

Estructura del proyecto

expense-tracker-mcp-server/
├── main.py             # MCP server entry point (all tools)
├── expenses.db         # SQLite database (auto-created on first run)
├── pyproject.toml      # Project metadata and dependencies
├── .venv/              # Virtual environment (created by uv)
└── readme.md

Requisitos previos

• Python 3.11+

• uv (recomendado) o pip

• Claude Desktop (para conectar el servidor MCP)

Instalación

# Clone the repo
git clone https://github.com/your-username/expense-tracker-mcp-server.git
cd expense-tracker-mcp-server

# Initialize the project and install dependencies
uv init
uv add fastmcp

Esto crea una carpeta .venv automáticamente dentro del directorio del proyecto.

Ejecución del servidor

fastmcp run main.py

El servidor se inicia y escucha las conexiones MCP a través de stdio. La base de datos SQLite (expenses.db) se crea automáticamente en la primera ejecución.

Conexión a Claude Desktop

Añade lo siguiente a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "expense-tracker": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Learning\\Expense-Tracker-MCP-Server",
        "run",
        "fastmcp",
        "run",
        "main.py"
      ]
    }
  }
}

Cierra completamente Claude Desktop (bandeja del sistema → Salir) y vuelve a abrirlo. Deberías ver las herramientas de seguimiento de gastos disponibles en el panel de herramientas.

Ejemplos de prompts

Una vez conectado a Claude, puedes decir:

• "Añade un gasto de 45 $ para comestibles en Whole Foods hoy"

• "Muéstrame todos los gastos de comida de este mes"

• "¿En qué gasté más el mes pasado?"

• "Establece un presupuesto mensual de 300 $ para salir a comer"

• "¿Cuánto queda de mi presupuesto de entretenimiento?"

• "Exporta todos mis gastos de marzo como CSV"

Desarrollo

# Run with MCP inspector for debugging
fastmcp dev inspector main.py

Licencia

MIT