Servidor MCP de Rastreador de Finanzas

Análisis de finanzas personales impulsado por IA a través de Claude AI utilizando el Protocolo de Contexto de Modelo (MCP).

¿Qué hace esto?

Este servidor MCP conecta a Claude AI con datos de transacciones financieras, permitiendo consultas en lenguaje natural sobre tus finanzas:

• "Muéstrame mis gastos de este mes"

• "Encuentra todas mis suscripciones"

• "¿Cuáles fueron mis 10 gastos principales?"

• "Muestra las tendencias de gasto de los últimos 3 meses"

• "Busca todas las transacciones de Starbucks"

• "Revisa mi presupuesto: Restaurantes $500, Compras $300"

Related MCP server: My Finance MCP Server

Características

• 6 Herramientas de Análisis Financiero

  • Resúmenes de gastos mensuales

  • Detección de suscripciones (cargos recurrentes)

  • Seguimiento y alertas de presupuesto

  • Análisis de tendencias de gasto

  • Clasificación de gastos principales

  • Búsqueda de transacciones

• Integración con Plaid

  • Conexión a más de 10,000 bancos (modo sandbox para pruebas)

  • Datos de transacciones en tiempo real (cuando se conecta a cuentas reales)

  • Acceso seguro a la API

• Privacidad primero

  • Todos los datos permanecen locales en tu máquina

  • Sin almacenamiento de datos externo

  • Conexiones API cifradas

Inicio rápido

Requisitos previos

• Python 3.9 o superior

• Aplicación Claude Desktop

• Cuenta de Plaid (gratuita en https://dashboard.plaid.com)

Instalación

1. Clona el repositorio

   git clone https://github.com/yourusername/finance-plaid-mcp.git
   cd finance-plaid-mcp

2. Crea un entorno virtual

   python -m venv venv
   
   # Activate it:
   # Windows:
   venv\Scripts\activate
   # Mac/Linux:
   source venv/bin/activate

3. Instala las dependencias

   pip install -r requirements.txt

4. Configura las claves de la API de Plaid

   Copia .env.example a .env y añade tus claves de Plaid desde https://dashboard.plaid.com

   PLAID_CLIENT_ID=your_client_id_here
   PLAID_SECRET=your_sandbox_secret_here
   PLAID_ENV=sandbox
   DATA_DIR=./data

5. Genera datos de muestra (para pruebas)

   python generate_sample_data.py

6. Configura Claude Desktop

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

   Windows: %APPDATA%\Claude\claude_desktop_config.json

   Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "finance-tracker": {
         "command": "python",
         "args": [
           "/FULL/PATH/TO/finance-plaid-mcp/src/server.py"
         ]
       }
     }
   }

Importante: ¡Usa la ruta absoluta completa a tu proyecto!

7. Reinicia Claude Desktop

8. ¡Pruébalo!

   En Claude, pregunta: "Encuentra todas mis suscripciones"

📁 Estructura del Proyecto

finance-plaid-mcp/ ├── src/ │ ├── server.py # Servidor MCP (punto de entrada principal) │ ├── plaid_client.py # Integración con la API de Plaid │ ├── analyzer.py # Lógica de análisis de transacciones │ └── config.py # Configuración y variables de entorno ├── data/ │ └── sample_transactions.json # Datos de prueba generados ├── screenshot.png # Captura de pantalla de demostración ├── .env # Tus claves API (NO se suben a git) ├── .env.example # Plantilla para claves API ├── .gitignore # Evita subir secretos ├── requirements.txt # Dependencias de Python └── README.md # Este archivo

🔧 Herramientas Disponibles

Claude puede llamar a estas herramientas al analizar tus finanzas:

🏦 Conexión de Cuentas Bancarias Reales

Actualmente en Modo Sandbox (solo datos de prueba)

Para conectar bancos reales:

1. Cambia al modo de Desarrollo en el panel de Plaid

2. Actualiza .env: PLAID_ENV=development

3. Implementa la interfaz de usuario de Plaid Link (interfaz web para inicio de sesión bancario)

Para propósitos de portafolio/demostración, se recomienda el modo sandbox para evitar exponer datos financieros reales.

📊 Salida de Muestra

Encontrando Suscripciones: 19 suscripciones encontradas por un total de $18,123/año Suscripciones principales:

Comcast Internet: $130.71/mes ($915 total) Apple Store: $180.05/mes ($900 total) Verizon Phone Bill: $110.75/mes ($886 total) Electric Bill: $119.86/mes ($839 total) Zara: $151.91/mes ($760 total)

Resumen Mensual: Total mensual: $1,510 Ingresos: $5,000 Gastos: $3,490 Neto: $1,510 Gastos por categoría:

Groceries: $644 Shopping: $900 Utilities: $886 Dining: $450 Transportation: $380

🛠️ Stack Tecnológico

• Python 3.14

• MCP SDK - Protocolo de Contexto de Modelo

• Plaid API - Conexión bancaria y datos de transacciones

• Pandas - Análisis de datos

• Claude AI - Interfaz de lenguaje natural

🔐 Seguridad y Privacidad

• ✅ Claves API almacenadas en .env (nunca subidas)

• ✅ Todos los datos procesados localmente

• ✅ Sin registros ni analíticas externas

• ✅ Plaid proporciona cifrado de nivel bancario

⚠️ Importante: ¡Nunca subas tu archivo .env o claves API a GitHub!

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Siéntete libre de:

• Reportar errores

• Sugerir características

• Enviar solicitudes de extracción (pull requests)

📝 Licencia

Licencia MIT

🙏 Agradecimientos

• Creado con MCP de Anthropic

• Impulsado por Plaid

⭐ Si te resultó útil, ¡por favor dale una estrella al repositorio!