Servidor MCP de servicio de contabilidad

Servidor MCP para acceder y administrar archivos de contabilidad a través de Claude.

Componentes

Herramientas

El servidor implementa tres herramientas para la gestión del libro mayor:

list-accounts : enumera todas las cuentas en el libro mayor
- Toma "año" como argumento obligatorio
- Devuelve una lista formateada de todas las cuentas disponibles
account-balance : Obtiene el saldo de una cuenta específica
- Toma "año" y "cuenta" como argumentos obligatorios
- Devuelve el saldo actual de la cuenta especificada
account-register : Muestra el registro de transacciones de una cuenta
- Toma "año" y "cuenta" como argumentos obligatorios
- Devuelve el historial detallado de transacciones de la cuenta especificada

Instalación

Prerrequisitos

Python 3.13 o superior
administrador de paquetes uv
Node.js y npm (para depuración)

Instalar desde PyPI

uv pip install ledger-service

Depuración

Usando el inspector para depurar el servidor:

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/ledger-service \
  run \
  ledger-service

Configurar Claude Desktop

Agregue la configuración del servidor al archivo de configuración de Claude Desktop:

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

"mcpServers": {
  "ledger-service": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/ledger-service",
      "run",
      "ledger-service"
    ]
  }
}

"mcpServers": {
  "ledger-service": {
    "command": "uvx",
    "args": [
      "ledger-service"
    ]
  }
}

Desarrollo

Configuración local

Clonar el repositorio
Crear y activar un entorno virtual
Instalar dependencias:

La ruta base se puede configurar modificando la constante LEDGER_BASE_PATH en server.py .

Licencia

LICENCIA PÚBLICA GENERAL GNU Versión 3, 29 de junio de 2007

Ledger MCP Server