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

Related MCP server: GOAT MCP Server

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

1. Clonar el repositorio

2. Crear y activar un entorno virtual

3. 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