Servidor MCP de Lunchmoney
Un servidor de Protocolo de Contexto Modelo (MCP) que le permite interactuar con sus transacciones y presupuestos de Lunchmoney a través de Claude y otros asistentes de IA.
¿Qué es esto?
Esta herramienta te permite conectar tus datos financieros de Lunchmoney con Claude AI, para que puedas hacer preguntas sobre tus gastos, analizar tu presupuesto y obtener información sobre tus finanzas a través de una conversación natural.
Características
Este servidor proporciona cuatro herramientas principales:
- get-recent-transactions : Ver sus transacciones recientes de los últimos N días
- buscar-transacciones : buscar transacciones por palabra clave en nombres de beneficiarios o notas
- get-category-spending : Analiza el gasto en categorías específicas
- get-budget-summary : Obtenga información detallada del presupuesto, incluidos gastos, montos restantes y elementos recurrentes
Privacidad y manejo de datos
Importante: MCP proporciona una forma estructurada para que Claude interactúe con sus datos de Lunchmoney, respetando la privacidad. Esto es lo que debe saber:
- Claude (el anfitrión) crea un cliente que se conecta a su servidor MCP local
- Su token API de Lunchmoney permanece en su máquina local
- El servidor MCP se ejecuta localmente y obtiene datos de la API de Lunchmoney
- Se le pedirá que apruebe cada solicitud para acceder a sus datos de Lunchmoney
- Cuando haces una pregunta sobre tus finanzas, Claude solicita información específica del servidor MCP
- El servidor MCP procesa su solicitud localmente y devuelve solo los resultados relevantes
- Claude nunca tiene acceso directo a sus datos financieros completos ni a su token API
- Solo se comparte con Claude la información específica solicitada (como resúmenes de transacciones o estado del presupuesto).
- Las políticas de retención de datos de Anthropic se aplican a estos resultados resumidos que forman parte de su conversación
- Cada conexión de servidor está aislada, manteniendo límites de seguridad claros
Puede encontrar más información sobre MCP en la documentación: https://modelcontextprotocol.io/introduction
Instalación
Consulte también la documentación oficial de Claude: https://modelcontextprotocol.io/quickstart/user
Usando npx
Node.js es una plataforma de software que le permite ejecutar código JavaScript en su computadora (fuera de un navegador web).
Para instalar Node.js:
- Windows/Mac : Descargue y ejecute el instalador desde el sitio web oficial de Node.js
- Mac con Homebrew : Ejecute
brew install node en la terminal - Linux : use su administrador de paquetes (por ejemplo,
sudo apt install nodejs para Ubuntu)
Una vez que Node.js esté instalado en su computadora, puede ejecutar el servidor directamente sin descargar nada:
- Obtén tu token de API de Lunchmoney desde la configuración de desarrollador de Lunchmoney
- Abra Claude Desktop
- Vaya a Configuración → Desarrollador ->
Edit Config - Agregue la siguiente configuración:
{
"mcpServers": {
"lunchmoney": {
"command": "npx",
"args": ["-y", "lunchmoney-mcp-server"],
"env": {
"LUNCHMONEY_TOKEN": "your_token_here"
}
}
}
}
Reemplace your_token_here con su token API de Lunchmoney real.
Nota importante: después de cambiar la configuración, es posible que deba reiniciar Claude Desktop para que los cambios surtan efecto.
Ejemplo de uso
Una vez configurado en Claude Desktop, podrás hacer preguntas como:
Actas
- "Muéstrame mis transacciones recientes de la semana pasada"
- Buscar todas las transacciones en Amazon
- "¿Cuánto gasté en restaurantes el mes pasado?"
- "Buscar transacciones etiquetadas como gastos comerciales"
Presupuestos
- "Muéstrame el resumen de mi presupuesto de este mes"
- ¿Cuál es el estado de mi presupuesto de enero a marzo de 2024?
- "¿Cuánto me queda de mi presupuesto de alimentación?"
- "Muéstrame las categorías en las que me he pasado del presupuesto"
¿Qué es MCP?
El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que estandariza cómo las aplicaciones proporcionan contexto a los Modelos de Lenguaje Grandes (LLM). Piense en MCP como un puerto USB-C para aplicaciones de IA: proporciona una forma estandarizada de conectar los modelos de IA a diferentes fuentes de datos y herramientas.
Algunos beneficios clave del MCP:
- Forma estandarizada de exponer datos y funcionalidades a los LLM
- Seguridad con intervención humana (todas las acciones requieren la aprobación del usuario)
- Ecosistema en crecimiento de integraciones prediseñadas
- Funciona con múltiples modelos y aplicaciones de IA.
Solución de problemas
Claude dice que no puede conectarse a mi servidor MCP:
- Asegúrese de que la configuración en la configuración de desarrollador de Claude sea correcta
- Intente reiniciar Claude Desktop después de cambiar la configuración
- Comprueba que tu token API de Lunchmoney sea válido
Claude no reconoce los comandos de Lunchmoney:
- Iniciar una nueva conversación en Claude
- Intente mencionar explícitamente Lunchmoney en su consulta (por ejemplo, "Muéstrame mis transacciones recientes de Lunchmoney")
Notas de la API
- Los datos presupuestarios deben utilizar límites mensuales para las fechas (por ejemplo, del 01/01/2024 al 31/01/2024)
- Las transacciones pueden utilizar cualquier rango de fechas
- Todos los valores monetarios se devuelven en su moneda original.
Licencia
Instituto Tecnológico de Massachusetts (MIT)
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.