mcp-server-ledger: Un servidor MCP de Ledger CLI

Descripción general

Un servidor de Protocolo de Contexto de Modelo para interactuar con Ledger CLI , un potente sistema de contabilidad de partida doble accesible desde la línea de comandos. Este servidor permite que los Modelos de Lenguaje Grandes consulten y analicen sus datos financieros mediante la herramienta Ledger CLI.

Este servidor MCP expone la funcionalidad de Ledger CLI a través de una interfaz estandarizada, lo que facilita que los asistentes de IA lo ayuden con informes financieros, análisis de presupuestos y tareas de contabilidad.

Características

El servidor proporciona las siguientes herramientas que se asignan a los comandos CLI de Ledger:

1. ledger_balance

   • Muestra los saldos de las cuentas con potentes opciones de filtrado.

   • Entradas: patrón de consulta, rangos de fechas, opciones de visualización

   • Devoluciones: Informe de saldo formateado

2. ledger_register

   • Muestra el registro de transacciones con el historial detallado.

   • Entradas: patrón de consulta, rangos de fechas, opciones de clasificación

   • Devoluciones: Informe de registro formateado

3. ledger_accounts

   • Enumera todas las cuentas en el archivo contable

   • Entrada: patrón de consulta opcional

   • Devoluciones: Lista de cuentas coincidentes

4. ledger_payees

   • Enumera todos los beneficiarios de las transacciones

   • Entrada: patrón de consulta opcional

   • Devoluciones: Lista de beneficiarios coincidentes

5. ledger_commodities

   • Enumera todos los productos (monedas) utilizados

   • Entrada: patrón de consulta opcional

   • Devoluciones: Lista de productos coincidentes

6. ledger_print

   • Imprime transacciones en formato de libro mayor

   • Entradas: patrón de consulta, rangos de fechas

   • Devoluciones: Entradas contables formateadas

7. ledger_stats

   • Muestra estadísticas sobre el archivo de contabilidad

   • Entrada: patrón de consulta opcional

   • Devoluciones: Resumen estadístico del libro mayor

8. ledger_budget

   • Muestra análisis de presupuesto

   • Entradas: patrón de consulta, rangos de fechas, período del informe

   • Devoluciones: Informe de presupuesto

9. ledger_raw_command

   • Ejecuta un comando CLI de Ledger sin procesar

   • Entrada: argumentos del comando como una lista de cadenas

   • Devuelve: Salida del comando como texto

Prerrequisitos

• Ledger CLI debe estar instalado y disponible en su PATH

• Un archivo Ledger válido con sus datos financieros

Instalación

Uso de uv (recomendado)

La forma más fácil de instalar y ejecutar este servidor es con uv :

Configuración

El servidor requiere la ruta a su archivo Ledger. Puede obtenerla mediante:

• La variable de entorno LEDGER_FILE

• Argumentos de la línea de comandos al iniciar el servidor

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Ejemplos de uso

Una vez configurado, puedes hacerle preguntas a tu asistente de IA sobre tus datos financieros:

• "Muéstrame mis gastos del último mes"

• "¿Cuál es mi saldo actual en todas las cuentas?"

• "Enumerar todas las transacciones con Amazon"

• "¿Cuánto gasté en comestibles en 2023?"

• "Muéstrame el rendimiento de mi presupuesto para el primer trimestre"

La IA utilizará los comandos CLI de Ledger adecuados a través del servidor para obtener la información.

Depuración

Para pruebas locales más detalladas:

Desarrollo

Este servidor se creó con el SDK de Python del Protocolo de Contexto de Modelo . Para más información sobre MCP y cómo desarrollar servidores MCP, consulte la documentación oficial .

Para contribuir a este proyecto:

1. Clonar el repositorio

2. Instalar dependencias de desarrollo

3. Realiza tus cambios

4. Pruebe utilizando el inspector MCP o integrándolo con Claude Desktop

Consideraciones de seguridad

Este servidor ejecuta comandos de la CLI de Ledger en sus datos financieros. Si bien incluye validación básica para evitar la inyección de comandos, le recomendamos:

• Úselo solo con clientes de confianza

• Tenga cuidado con las rutas de archivos que expone

• Revisar todos los comandos antes de su ejecución

Licencia

Este servidor MCP está licenciado bajo la licencia MIT. Puede usarlo, modificarlo y distribuirlo libremente según los términos de la licencia.