
mcp-server-ledger: A Ledger CLI MCP Server

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 助手帮助用户管理和分析财务数据。
核心功能
- ledger_balance:显示账户余额,支持强大的过滤选项。
- ledger_register:显示交易记录,支持详细的历史查询。
- ledger_accounts:列出账本文件中的所有账户。
- ledger_payees:列出交易中的所有收款人。
- ledger_commodities:列出所有使用的货币(商品)。
- ledger_print:以账本格式打印交易记录。
- ledger_stats:显示账本文件的统计信息。
- ledger_budget:显示预算分析。
- ledger_raw_command:运行原始的 Ledger CLI 命令。
适用场景
- 财务报告生成
- 预算分析
- 交易历史查询
- 账户余额查询
- 财务数据统计
工具列表
- ledger_balance:查询账户余额。
- ledger_register:查询交易记录。
- ledger_accounts:列出账户。
- ledger_payees:列出收款人。
- ledger_commodities:列出货币。
- ledger_print:打印交易记录。
- ledger_stats:统计账本数据。
- ledger_budget:分析预算。
- ledger_raw_command:运行原始命令。
常见问题解答
- 如何设置账本文件路径?:通过
LEDGER_FILE
环境变量或命令行参数设置。 - 如何调试?:使用
mcp dev main.py
命令进行本地测试。 - 如何防止命令注入?:服务器包含基本验证,但建议仅与受信任的客户端一起使用。
使用教程
使用依赖
- 安装 Ledger CLI 并确保其在 PATH 中。
- 准备一个有效的账本文件。
安装教程
推荐使用 uv 安装:
uv sync
配置
设置账本文件路径:
- 通过
LEDGER_FILE
环境变量。 - 通过命令行参数。
调试方式
mcp dev main.py