mcp-server-ledger: A Ledger CLI MCP Server

mcp-server-ledger: A Ledger CLI MCP Server

site icon
2025.03.22 7
Python财务服务会计系统预算分析金融服务
mcp-server-ledger 是一个基于 Ledger CLI 的 MCP 服务器,用于通过标准化接口与 Ledger CLI(一个强大的双入口会计系统)进行交互。该服务器允许大型语言模型通过 Ledger CLI 工具查询和分析用户的财务数据,从而帮助用户完成财务报告、预算分析和会计任务。
View on GitHub

Overview

基本能力

产品定位

mcp-server-ledger 是一个为 Ledger CLI 提供 MCP 接口的服务器,旨在通过 AI 助手帮助用户管理和分析财务数据。

核心功能

  1. ledger_balance:显示账户余额,支持强大的过滤选项。
  2. ledger_register:显示交易记录,支持详细的历史查询。
  3. ledger_accounts:列出账本文件中的所有账户。
  4. ledger_payees:列出交易中的所有收款人。
  5. ledger_commodities:列出所有使用的货币(商品)。
  6. ledger_print:以账本格式打印交易记录。
  7. ledger_stats:显示账本文件的统计信息。
  8. ledger_budget:显示预算分析。
  9. ledger_raw_command:运行原始的 Ledger CLI 命令。

适用场景

  • 财务报告生成
  • 预算分析
  • 交易历史查询
  • 账户余额查询
  • 财务数据统计

工具列表

  1. ledger_balance:查询账户余额。
  2. ledger_register:查询交易记录。
  3. ledger_accounts:列出账户。
  4. ledger_payees:列出收款人。
  5. ledger_commodities:列出货币。
  6. ledger_print:打印交易记录。
  7. ledger_stats:统计账本数据。
  8. ledger_budget:分析预算。
  9. ledger_raw_command:运行原始命令。

常见问题解答

  • 如何设置账本文件路径?:通过 LEDGER_FILE 环境变量或命令行参数设置。
  • 如何调试?:使用 mcp dev main.py 命令进行本地测试。
  • 如何防止命令注入?:服务器包含基本验证,但建议仅与受信任的客户端一起使用。

使用教程

使用依赖

  • 安装 Ledger CLI 并确保其在 PATH 中。
  • 准备一个有效的账本文件。

安装教程

推荐使用 uv 安装:

uv sync

配置

设置账本文件路径:

  • 通过 LEDGER_FILE 环境变量。
  • 通过命令行参数。

调试方式

mcp dev main.py

许可证

该项目遵循 MIT 开源许可条款。