local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Used to set the LEDGER_FILE environment variable for configuring the path to the user's ledger file

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:

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
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
ledger_accounts
- Enumera todas las cuentas en el archivo contable
- Entrada: patrón de consulta opcional
- Devoluciones: Lista de cuentas coincidentes
ledger_payees
- Enumera todos los beneficiarios de las transacciones
- Entrada: patrón de consulta opcional
- Devoluciones: Lista de beneficiarios coincidentes
ledger_commodities
- Enumera todos los productos (monedas) utilizados
- Entrada: patrón de consulta opcional
- Devoluciones: Lista de productos coincidentes
ledger_print
- Imprime transacciones en formato de libro mayor
- Entradas: patrón de consulta, rangos de fechas
- Devoluciones: Entradas contables formateadas
ledger_stats
- Muestra estadísticas sobre el archivo de contabilidad
- Entrada: patrón de consulta opcional
- Devoluciones: Resumen estadístico del libro mayor
ledger_budget
- Muestra análisis de presupuesto
- Entradas: patrón de consulta, rangos de fechas, período del informe
- Devoluciones: Informe de presupuesto
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 :

uv sync

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 :

"mcpServers": {
  "ledger": {
    "command": "uv",
    "args": [
      "run",
      "--env-file",
      "/path/to/your/.env",  // Optional: to set LEDGER_FILE
      "--with",
      "mcp[cli]",
      "mcp",
      "run",
      "<repo_path>/main.py"  // Path to the main.py file in this repository
    ]
  }

}

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:

mcp dev main.py

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:

Clonar el repositorio
Instalar dependencias de desarrollo
Realiza tus cambios
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.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA consultar y analizar datos financieros a través de Ledger CLI, lo que habilita tareas como informes financieros, análisis de presupuestos y contabilidad.

Ledger CLI MCP Server